home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / bbs / ezrom22b.zip / EZROM.DOC < prev    next >
Text File  |  1996-01-14  |  132KB  |  2,646 lines
  1.  
  2.                               EZ-ROM DOOR
  3.                              Version  2.20
  4.                          Released Jan 14, 1996
  5.  
  6.                  Copyright 1992-1996 by Michael Robinson
  7.                       Internet: TheMikeRob@aol.com
  8.  
  9.                           The Soft Parade BBS
  10.                         Shelton, Connecticut, USA
  11.                         1:141/485    203-924-5603
  12.                         1:141/486    203-922-1794
  13.                 Fast Online registration using Visa/Mastercard
  14.  
  15.       EZ-ROM is a file download door for any DOS BBS. Direct support for
  16.       Wildcat 3 & 4, PCBoard, RemoteAccess, ProBoard, Maximus 2 & 3, TAG,
  17.       TriBBS 10. Uses DOOR.SYS or DORINFOx.DEF door drop file. Supports
  18.       plain UART, FOSSIL driver, or DigiBoard. X/Y/Zmodem internal
  19.       protocols. Files may be located on CD-ROM disk or magnetic disk.
  20.  
  21.       Features include: up to 228 disks, up to 700 file areas per disk,
  22.       maintains it's own user/download database, requests from offline
  23.       disks, disk volume name detection, automatic menu creation,
  24.       create/download file lists, full multi-node and network support,
  25.       batch downloads from within the door, file tagging, fast text search
  26.       single or all disks, ZIP and text file viewer, insertion of BBS ads
  27.       into ZIP files, multi-disk changer support, automatic request
  28.       manager/editor program, user manager/editor program, configurable
  29.       user limits, chat mode, local drop to DOS, and DESQview aware. Can
  30.       be run in local copy-to-hardrive mode in the BBS or from the DOS
  31.       command line.
  32.  
  33.       A plain ASCII text file list is used for each file area. These lists
  34.       are often supplied on the CD-ROM disk and can be used with little or
  35.       no modification. Special compiled file lists are NOT required. EZ-ROM
  36.       automatically supports multi-line file descriptions and it works
  37.       especially well with Night Owl and Spitfire format multi-line lists.
  38.       Optional formatting commands can be used to change the display
  39.       position on each line of the filename, size, date, and description.
  40.       Configurable display color too.
  41.  
  42.       EZ-ROM is unique among CD-ROM doors because it maintains it's own
  43.       separate DATABASE to record caller download information and limit the
  44.       number of files/bytes downloaded and requested. In addition, it can
  45.       also record files/bytes downloaded in the following file formats:
  46.  
  47.       DOOR.SYS ......... read back by TriBBS 10 and others
  48.       USERREC.BIN ...... Wildcat 4.x BBS
  49.       USERINFO.DAT ..... Wildcat 3.x BBS
  50.       USERS.SYS ........ PCBoard BBS
  51.       EXITINFO.BBS ..... RemoteAccess 2.x and ProBoard
  52.       LASTUSxx.BBS ..... Maximus 2.x and 3.x
  53.       USER.LST ......... TAG
  54.  
  55.       These files are then read back by the BBS which then updates the
  56.       main BBS database with the number of files/bytes downloaded.
  57.  
  58.       EZ-ROM can also serve as a very configurable menu extension. From the
  59.       same main menu a caller can choose from a selection of CD-ROM disks,
  60.       magnetic disk file areas, and external doors. These may be used in
  61.       any combination. When an external door is chosen, EZ-ROM exits with
  62.       an ErrorLevel which is then used in a batch file to pass control to
  63.       the selected external door.
  64.  
  65.       There is special support designed in for multiple nodes and/or
  66.       multiple CD-ROM drives such as the Pioneer DRM series disk changers.
  67.       EZ-ROM acts as a traffic cop to control access, avoid collisions,
  68.       and prevent "thrashing" that can sometimes occur when multiple
  69.       users try to access the same drive.
  70.  
  71.       Considerable time and energy was spent working around the speed
  72.       limitations of today's CD-ROM drives. Actual CD-ROM drive hardware
  73.       access time has been minimized by:
  74.  
  75.       1. Maintaining the file lists on the magnetic drive. This is
  76.          optional. If the CD-ROM itself contains file lists, these can be
  77.          be accessed directly by the door in order to save hard drive
  78.          space. The same file lists may be shared by all nodes.
  79.       2. Copying the file to a holding directory on the hard drive and
  80.          downloading it from there. This is also optional. You can
  81.          configure the door to download directly from the CD-ROM drive.
  82.       3. Careful design of the door logic. The CD-ROM drive hardware is
  83.          accessed as rapidly as possible and only when absolutely required.
  84.       4. When files are copied from multiple disks, each disk is only
  85.          accessed once even if the caller did not select the files in
  86.          order by disk.
  87.  
  88.       FEATURES LIST:
  89.  
  90.       ■ Up to 228 disks. Up to 700 file areas per disk.
  91.  
  92.       ■ Direct support for Wildcat 3 & 4, PCBoard, RemoteAccess, ProBoard,
  93.         Maximus 2 & 3, TAG, TriBBS 10.
  94.  
  95.       ■ Supports plain UART, FOSSIL, or DigiBoard.
  96.  
  97.       ■ Batch downloads from within door using internal protocols:
  98.         Xmodem, Ymodem or Zmodem. Zmodem includes crash recovery of
  99.         aborted downloads and transmits total batch download statistics
  100.         to the file receiver.
  101.  
  102.       ■ File Tagging while listing and while searching.
  103.  
  104.       ■ Fast text search of a file area, a whole disk, or all disks.
  105.  
  106.       ■ Online ZIP file and text file viewer.
  107.  
  108.       ■ Maintains it's own user/download database file that limits daily
  109.         downloads and requests on ANY BBS type. (registered version)
  110.         Configurable limits based on security level, files, bytes, ratios.
  111.         Includes EZ-User - Database Manager/Editor program.
  112.  
  113.       ■ Requests from offline disks. (registered version)
  114.         Includes EZ-Request - Automatic Request Manager/Editor program.
  115.         This program prompts the sysop to insert a disk into the drive, and
  116.         then copies all pending requests for that disk before prompting for
  117.         the next disk. Caller receives a message when entering the door if
  118.         requested files are ready for download. If successfully downloaded,
  119.         the files are deleted when the caller exits the door. If the caller
  120.         does not download the files, they are held for a configurable
  121.         number of days and then deleted.
  122.  
  123.       ■ Disk Detection. Reads volume name of the disk in the drive and sets
  124.         disk online status. Once configured, you can simply swap disks and
  125.         make NO changes to any config files. EZ-ROM will do the rest. It
  126.         will read the volume name, set the correct status for each disk,
  127.         and display the status in the menu display.
  128.  
  129.       ■ AutoMenu. Constructs the main disk selection menu of all disks
  130.         on-the-fly. EZ-ROM will create and display the main menu which
  131.         indicates which disks are online, request, or offline. Or you can
  132.         create your own custom ANSI/ASCII menu screens MAIN.CLR & MAIN.BBS.
  133.  
  134.       ■ Automatic file list creation and download. Can construct,
  135.         optionally ZIP, and send a list of all files on a disk. It
  136.         constructs this list on-the-fly by reading the configuration files.
  137.         Fully automatic. Built-in ZIP function, does not require PKZIP.
  138.  
  139.       ■ Inserts BBS advertisements into ZIP files. (registered version)
  140.         Uses optional batch file execution before and/or after download.
  141.  
  142.       ■ Special support for multi-disk changers such as Pioneer and NEC.
  143.         Prevents changer "collisions" on multi-node systems.
  144.  
  145.       ■ File sharing and locking for multinode and network operation. All
  146.         file lists, menus, data files and logs may be shared.
  147.  
  148.       ■ Communication port speeds to 115,200 bps with hardware or software
  149.         flow control. Automatically reads the communication port hardware
  150.         (UART) to determine port speed, data bits, stop bits and parity.
  151.         Port number to use is read from DOOR.SYS or DORINFOx.DEF. Port
  152.         number, IRQ number, and IO base address, can be set manually to
  153.         handle non-standard ports. Handles any UART, including the
  154.         16550AFN.
  155.  
  156.       ■ The door will recognize caller connect speeds from 0 to 230,400
  157.         bits per second. It will use the value passed in DOOR.SYS line 2,
  158.         or DORINFOx.DEF line 5, to calculate the estimated download times.
  159.         Note that sometimes this value is incorrect. Some modems connect at
  160.         12000, 14400, 16800, 19200, 21600, 24000, 26400, 28800, but "lie"
  161.         and tell The BBS that the connect is 9600 or some other value. Some
  162.         BBS systems and door drop file converters erroneously pass the port
  163.         speed (such as 38400) instead of the connect speed. The door
  164.         automatically factors in a speed increase due to error correction.
  165.  
  166.       ■ DESQview aware. Releases time slices (clock tics) to tasks
  167.         running in other windows when EZ-ROM is idle.
  168.  
  169.       ■ Chat Mode
  170.       ■ Local drop to DOS
  171.       ■ Carrier detection. Resets the BBS if caller drops carrier.
  172.       ■ Inactivity timeout configurable from 1 to 10 minutes.
  173.       ■ Detailed status lines always visible on top of local screen.
  174.       ■ Detailed status screen displayed during download.
  175.       ■ Custom display screens.
  176.       ■ Optional logoff after transfer.
  177.       ■ Optional time penalty for dropped carrier.
  178.       ■ Logging of all caller activities to any file. (registered version)
  179.  
  180.       EZ-ROM is shareware with a $30 registration. See the end of this file
  181.       or REGISTER.DOC for registration form and information.
  182.  
  183.  
  184. ----- SETUP INSTRUCTIONS ------------------------------------------------
  185.  
  186.       Here is the quick version of the setup instructions:
  187.  
  188.       1. Unzip this archive into one subdirectory.
  189.       2. Edit the included EZROM.MAS master configuration file.
  190.       3. Create a separate directory for each CD-ROM disk.
  191.       4. Copy EZROM.CFG to each directory. Edit each EZROM.CFG.
  192.       5. Copy the file lists to each directory. Edit lists if required.
  193.       6. Copy DISK.CLR and DISK.BBS to each directory. Edit as required.
  194.       7. Run the program in local mode: EZROM LOCAL
  195.          Run the program online: EZROM  C:\BBS\DOOR.SYS  C:\CDROM\EZROM.MAS
  196.  
  197.       Take a quick look at EZROM.MAS, EZROM.CFG, DISK.BBS, and you
  198.       will get the general idea. Try executing the command EZROM LOCAL
  199.       to get a quick look at the general appearance of the door.
  200.  
  201.       Here is a more detailed description of each step:
  202.  
  203.       1. Unzip this archive into one subdirectory. This will be the EZ-ROM
  204.          home directory, which is named C:\CDROM in the following example,
  205.          but any subdirectory name may be used. You only need one copy of
  206.          EZROM.EXE and it must be kept here.
  207.  
  208.       2. Modify the included EZROM.MAS file to meet your needs.
  209.          See CONFIGURATION COMMANDS below for description of each option.
  210.          This is the MASter file that sets the configuration and location
  211.          for all of the disks. It "points" to all of the separate EZROM.CFG
  212.          files used by each disk. Any line in EZROM.MAS that does not begin
  213.          with a letter is ignored. The lines that begin with semicolons,
  214.          for example, are used for comments and ignored by the program.
  215.          Keep this file in the EZ-ROM home directory.
  216.  
  217.       3. Create a separate subdirectory for each of your CD-ROM disks.
  218.          The general arrangement should look something like this:
  219.                             ┌───────────┐
  220.                             │ EZROM.EXE │ EZ-ROM home directory
  221.                             │ EZROM.MAS │
  222.                             └─────┬─────┘
  223.                                   │
  224.                 ┌─────────────────┼─────────────────┬────── - - - etc.
  225.          ┌──────┴───────┐  ┌──────┴───────┐  ┌──────┴───────┐
  226.          │ EZROM.CFG    │  │ EZROM.CFG    │  │ EZROM.CFG    │
  227.          │ DISK.BBS/CLR │  │ DISK.BBS/CLR │  │ DISK.BBS/CLR │
  228.          │ FILE LISTS   │  │ FILE LISTS   │  │ FILE LISTS   │
  229.          └──────────────┘  └──────────────┘  └──────────────┘
  230.           subdirectory      subdirectory       subdirectory
  231.           for disk 1        for disk 2         for disk 3
  232.  
  233.       4. Copy EZROM.CFG to each of the disk subdirectories. This is the
  234.          configuration file for that disk and must be modified to suit that
  235.          disk. EZROM.CFG must contain the disk name and all the paths to
  236.          the files and lists for that disk. This is all that MUST be
  237.          included, any of the other commands are optional, but they will be
  238.          applied if they are there.
  239.  
  240.          EZROM.CFG should also contain the TagChar command for that disk.
  241.          The TagChar command determines which lines of a file list are
  242.          assigned a tag letter and colorized when the list is displayed in
  243.          the door. You can assign any TagChar you like, but it should
  244.          be a character that repeats in the same location on every line
  245.          that contains a file. The default TagChar is a dash at position
  246.          26 which is the first dash in the file date in many lists. You
  247.          can also set TagChar ALL which will assign a tag letter to every
  248.          line in the file list.
  249.  
  250.       5. Prepare an ASCII text file list for each subdirectory on each
  251.          CD-ROM disk. These are often included on the CD-ROM and can
  252.          usually be used with little or no modification. Keep the lists in
  253.          the subdirectory for that disk or on the CD-ROM. The first line of
  254.          each file entry in the list should be in the following format:
  255.  
  256. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  257. EZROM22.ZIP   220,195  01-14-96  EZ-ROM v2.20, CD-ROM Door by Mike Robinson
  258. <---Name---><--Size--><-Date----><-------------Description------------------->
  259.  
  260.          This is the standard default single line format. The location and
  261.          display color of each field can be changed by using the FileName,
  262.          FileSize, FileDate, and FileDesc commands as described below in
  263.          the Configuration Commands section.
  264.  
  265.          If Spitfire style multi-line descriptions with "smiley face" 
  266.          (ASCII 02) character are used, the line may be up to 255
  267.          characters long and all on one line. The "smiley face" marks the
  268.          separation between lines. Spitfire multi-line format will be
  269.          automatically recognized by EZ-ROM if there is at least one
  270.          "smiley face" on the line. Spitfire v3.5 extended file
  271.          descriptions with a smiley face in column 1 are also recognized.
  272.  
  273.          For other multi-line formats, (such as Night Owl) the description
  274.          lines may lie on multiple lines between column 34 and 78 as shown:
  275.  
  276. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  277. <---Name---><--Size--><-Date----><-------------Description------------------->
  278. EZROM22.ZIP   220,195  01-14-96  EZ-ROM v2.20, CD-ROM Door by Mike Robinson
  279.                                | UART, FOSSIL, DIGIBOARD. Use DOOR.SYS
  280.                                | or DORINFOx.DEF. Keeps Own Database,
  281.                                | Enforces Limits, MultiDisk, MultiNode,
  282.                                | File Tagging, Text Search, Offline
  283.                                | Requests, ZIP & Text Viewer, Inserts
  284.                                  <-------------Description------------------->
  285.  
  286.          The character "|" is not required, although it is often included
  287.          in Night Owl type lists. EZ-ROM can be configured to not show this
  288.          character by using the DelChar configuration command.
  289.  
  290.          Descriptive headers may be used at the top of each file list or at
  291.          any point within the list. Any line which does not contain the tag
  292.          character at the proper location is assumed to be a description
  293.          line and is displayed without modification. See TAGCHAR in
  294.          Configuration Commands section below.
  295.  
  296.       6. Copy DISK.BBS and DISK.CLR to each of the disk subdirectories.
  297.          This is the display menu showing the file areas available on
  298.          the disk and must be modified to suit the disk. The .CLR is
  299.          an ANSI file. The .BBS is ASCII. Try to keep these to under
  300.          22 displayed lines or the top may scroll off the screen.
  301.  
  302.       7. Run the program online via a batch file such as DOOR1.BAT.
  303.          If you are using DOOR.SYS then the batch file should contain
  304.          these commands:
  305.  
  306.          CD C:\CDROM
  307.          EZROM  C:\BBS\DOOR.SYS  C:\CDROM\EZROM.MAS
  308.  
  309.          If you are using DORINFOx.DEF then the batch file should contain
  310.          these commands:
  311.  
  312.          CD C:\CDROM
  313.          EZROM  C:\BBS\DORINFO1.DEF  C:\CDROM\EZROM.MAS
  314.  
  315.          EZ-ROM uses the door drop file extension to determine which type
  316.          of door drop file to read. If the extension is .DEF then EZ-ROM
  317.          assumes it is a DORINFOx.DEF type, otherwise it assumes it is a
  318.          DOOR.SYS type.
  319.  
  320.  
  321. ----- MULTI-NODE OPERATION ----------------------------------------------
  322.  
  323.          If the configuration of each node is the same, then you can use
  324.          the same EZROM.MAS for all nodes. To do this, all paths to all
  325.          files and directories must be the same on every node. The node
  326.          number to use is read from DOOR.SYS or DORINFOx.DEF.
  327.  
  328.          If required, you can make separate partial configuration files for
  329.          each node (optional). On node 1, for example, create a file in the
  330.          current directory called NODE1.CFG. You must use this file name
  331.          for node 1. In this file put only the commands for this node that
  332.          are different from the commands in the EZROM.MAS master
  333.          configuration file. Typical use of the NODE?.CFG file would be to
  334.          specify non-standard port parameters using the commands ForceIrq
  335.          and ForceBase. But you can specify any command that you want
  336.          applied to that node only. This should allow you to use the same
  337.          EZROM.MAS for all nodes. For nodes other than 1, change the 1 in
  338.          NODE1.CFG to the node number of the node.
  339.  
  340.          If the file paths to all the files and lists are the same for all
  341.          nodes, then they can all share the same EZROM.CFG for each disk.
  342.          Setup on a network will be easier if you put all the file lists on
  343.          one drive and this drive is remapped to the same drive letter on
  344.          all nodes. It is also helpful for all CD-ROM drives to be remapped
  345.          such that each drive is known by the same drive letter on all
  346.          nodes.
  347.  
  348.          If your BBS runs a different batch file for each node, then the
  349.          command line to run EZ-ROM on node 1 might look like this:
  350.  
  351.          EZROM  C:\BBS\DOOR.SYS  C:\CDROM\EZROM.MAS
  352.  
  353.          If your BBS runs the same batch file for all nodes, then you may
  354.          be able to pass the node number in a DOS variable parameter. The
  355.          following example is for Wildcat BBS:
  356.  
  357.          EZROM  C:\WC40\WCWORK\NODE%WCNODEID%\DOOR.SYS  C:\CDROM\EZROM.MAS
  358.  
  359.          Wildcat places the node number in %WCNODEID%. When DOS executes
  360.          the command line, it replaces the %WCNODEID% with the node number.
  361.          So for node 1, the command line above becomes:
  362.  
  363.          EZROM  C:\WC40\WCWORK\NODE1\DOOR.SYS C:\CDROM\EZROM.MAS
  364.  
  365.          DOS variable parameters such as %WCNODEID% may be used in batch
  366.          files. But EZ-ROM does NOT support these DOS environment variables
  367.          in the configuration files EZROM.MAS and EZROM.CFG.
  368.  
  369.          For multi-node operation, it is important that you use the HomeDir
  370.          and RequestDir commands and that all nodes share the same HomeDir
  371.          and RequestDir. The database files EZROM.DAT (caller download
  372.          records) and EZROM.REQ (request records) are kept in the HomeDir.
  373.          The requested files are kept in the RequestDir. So if a caller
  374.          places a request on one node, but calls back to download the
  375.          request on another node, EZ-ROM will still be able to look up the
  376.          caller records in the HomeDir and retrieve the files from the
  377.          RequestDir. And the callers download records will be properly
  378.          maintained no matter which node he calls.
  379.  
  380.          You can also run a different EZROM.MAS for each node (optional).
  381.          You can name the files EZROM1.MAS, EZROM2.MAS, EZROM3.MAS, etc.
  382.          The extension must be .MAS, but any file name may be used. The
  383.          .MAS extension tells EZ-ROM to run in multi-disk mode. If you run
  384.          in single-disk mode, then you can use a different EZROM.CFG for
  385.          each node and name then EZROM1.CFG, EZROM2.CFG, EZROM3.CFG, etc.
  386.  
  387.  
  388. ----- LOCAL MODE --------------------------------------------------------
  389.  
  390.       EZ-ROM may be run in local mode if you log onto the BBS locally.
  391.       It may also be run in local mode from the DOS command line:
  392.  
  393.       CD C:\CDROM
  394.       EZROM  LOCAL
  395.  
  396.       Local mode allows you to browse the lists, tag files, and copy the
  397.       files (and descriptions) to the hard drive.
  398.  
  399.  
  400. ----- SETUP for SINGLE-DISK MODE ----------------------------------------
  401.  
  402.       Single disk mode is the same as multi-disk mode described above
  403.       except the EZROM.MAS file is not used. Therefore, all configuration
  404.       commands must be placed in EZROM.CFG. Run the program online in
  405.       single-disk mode via a batch file such as DOOR1.BAT which should
  406.       contain these commands:
  407.  
  408.          CD C:\CDROM
  409.          EZROM  C:\BBS\DOOR.SYS  C:\CDROM\EZROM.CFG
  410.  
  411.       The extension of .CFG (instead of .MAS) tells EZ-ROM to run in
  412.       single- disk mode. You may use DORINFOx.DEF in place of DOOR.SYS.
  413.  
  414.       When running local mode, if EZROM.MAS is found in the current
  415.       directory, then multi-disk mode is selected. If EZROM.CFG is found,
  416.       then single-disk mode is run.
  417.  
  418.  
  419. ----- CONFIGURATION COMMANDS --------------------------------------------
  420.  
  421.       The DISKS command must be used in EZROM.MAS.
  422.       The AREAS command must be used in EZROM.CFG.
  423.  
  424.       All other configuration commands are optional.
  425.  
  426.       Configuration commands are used in EZROM.MAS and EZROM.CFG. The
  427.       program reads each line of these files, and if the line begins with a
  428.       configuration command, then the configuration is modified as directed
  429.       by the command. If a line begins with anything other than a letter,
  430.       it is ignored. The explanatory comments are on lines beginning with a
  431.       semicolon and are therefore ignored. Each command must be all the way
  432.       up against the left margin of the file with the first command
  433.       character in column 1. The commands are NOT case sensitive, but they
  434.       must be spelled correctly. The commands may be placed in any order
  435.       within the file.
  436.  
  437.       Most of the configuration commands can be set in either (or both)
  438.       the master EZROM.MAS or the disk specific EZROM.CFG. The values in
  439.       EZROM.MAS prevail when the program is at the first menu. The values
  440.       in EZROM.CFG prevail whenever that disk is loaded or read. If no
  441.       value is specified in EZROM.CFG then the value in EZROM.MAS will
  442.       always be used. Some of the commands are only read once when the
  443.       program starts and are so indicated below.
  444.  
  445.  
  446.       The AREAS commands in EZROM.CFG should look something like this:
  447.  
  448.    AREAS
  449.    E:\001A     C:\CDROM\NIGHT18\DIR1
  450.    E:\002A     C:\CDROM\NIGHT18\DIR2
  451.    E:\003A     C:\CDROM\NIGHT18\DIR3
  452.    E:\004A     C:\CDROM\NIGHT18\DIR4
  453.    E:\005A     C:\CDROM\NIGHT18\DIR5
  454.    E:\006A     C:\CDROM\NIGHT18\DIR6
  455.    E:\007A     C:\CDROM\NIGHT18\DIR7
  456.    E:\008A     C:\CDROM\NIGHT18\DIR8
  457.    AREAS
  458.  
  459.       The AREAS configuration command is MANDATORY for all modes.
  460.       It is only used in EZROM.CFG. It is used to signify both the
  461.       beginning and end of a list of file areas. The example above shows
  462.       8 file areas, but you can have as many as 700 file areas per disk.
  463.       There must be one file area per line. The first line is file area
  464.       number 1 and the rest follow in order until you reach the end.
  465.  
  466.       The list MUST BEGIN and END with the keyword "AREAS".
  467.  
  468.       Each line has two entries separated by at least one blank space. The
  469.       first is the path to the file area on the CD-ROM. The second is the
  470.       full path and filename of the associated file list. So the basic
  471.       format of the AREAS section is:
  472.  
  473.       AREAS
  474.       (DIRECTORY 1)   (FILE LIST 1)
  475.       (DIRECTORY 2)   (FILE LIST 2)
  476.       (DIRECTORY 3)   (FILE LIST 3)
  477.       AREAS
  478.  
  479.       Each CD-ROM directory is paired with a matching list of files in that
  480.       directory. The file lists can have any valid DOS file name. The file
  481.       lists can be located on a normal magnetic hard disk or on the CD-ROM
  482.       (if they exist on the CD-ROM). The door will run much faster if you
  483.       locate the file lists on the normal magnetic hard disk. Note that you
  484.       can also use this door to access normal file areas on your hard
  485.       drive. You can mix normal file areas with CD-ROM areas in the same
  486.       door. The file areas do not have to reside on the same drive letter
  487.       or same physical drive. If you have a network, you can access file
  488.       areas on a different machine. You could even put ALL of your BBS file
  489.       areas in one or more of these doors. For example, you could put adult
  490.       files in one door and restrict access to adults only. Or you could
  491.       have special file doors reserved for privileged, contributing or
  492.       subscribing callers.
  493.  
  494.       The example above is a portion of the sample EZROM.CFG supplied in
  495.       this package. It is for the Night Owl 18 CD-ROM disk first published
  496.       in 1995. The file lists are resident on the CD-ROM and can be easily
  497.       copied to a hard drive.
  498.  
  499.  
  500.       The DISKS commands in EZROM.MAS should look something like this:
  501.  
  502.    DISKS
  503.    1   ON   >0   0   C:\CDROM\DISK1\EZROM.CFG  "Night Owl 18"
  504.    2   OFF  >0   0   C:\CDROM\DISK2\EZROM.CFG  "Arsenal Files 3"
  505.    3   OFF  >0   0   C:\CDROM\DISK3\EZROM.CFG  "So Much Shareware 5"
  506.    4   OFF  >0   0   C:\CDROM\DISK4\EZROM.CFG  "Cream of the Crop 10"
  507.    5   OFF  >0   0   C:\CDROM\DISK5\EZROM.CFG  "Pier 7"
  508.    6   OFF  >0   0   C:\CDROM\DISK6\EZROM.CFG  "Simtel MS DOS"
  509.    DISKS
  510.  
  511.       The DISKS configuration command is MANDATORY for multi-disk mode.
  512.       It is only used in EZROM.MAS and is for multi-disk mode only.
  513.       It is used to signify both the beginning and end of a list of disks.
  514.       Each line in the DISKS section "points" to a EZROM.CFG file for a disk.
  515.       The example above shows 6 disks, but you can have as many as 228.
  516.       There must be one disk per line.
  517.  
  518.       The list MUST BEGIN and END with the keyword "DISKS".
  519.  
  520.       COLUMN 1 is the string of characters that the caller types to select
  521.          the disk. Any string of up to 30 typeable characters may be used.
  522.          No blanks or untypeable characters. Must be one continuous string.
  523.          Do not use the single characters C, E, Q, R, S, or U since these
  524.          are used to select options on the main menu. But you may use words
  525.          of 2 or more characters that begin with these letters. The
  526.          simplest method may be to use a number to indicate each disk as
  527.          done in the example above. If you set AutoMenu ON, then the disks
  528.          will automatically be assigned selection numbers based on their
  529.          order and whatever is placed in this column will be ignored.
  530.       COLUMN 2 shows the disk or door status.
  531.          ON   means online. Downloads allowed. No requests.
  532.          OFF  means offline. Browse only. No downloads or requests allowed.
  533.          REQ  means requests allowed. No downloads. Registered version only.
  534.          CLO  means closed. Noone can enter this disk.
  535.          AUTO-REQ  means online if disk in drive, otherwise set to REQ
  536.          AUTO-OFF  means online if disk in drive, otherwise set to OFF
  537.          AUTO-CLO  means online if disk in drive, otherwise set to CLO
  538.          If you use any AUTO command for a disk, then you MUST use the
  539.          Volume command in the EZROM.CFG for that disk. See below.
  540.       COLUMN 3 shows the security level required to enter the disk.
  541.         For example if it is set to:
  542.         >5   (only security levels greater than 5 may enter)
  543.         <20  (only security levels less than 20 may enter)
  544.         =30  (only security level equal to 30 may enter)
  545.         There must be no spaces between the symbol and the level
  546.         number.
  547.       COLUMN 4 is the type. Set this to 0 for a CD-ROM disk. Set it any
  548.         value between 10 and 255 and EZ-ROM will terminate with this
  549.         ErrorLevel when this door is selected by the caller. This allows
  550.         EZ-ROM to be used like an external menu program. In this case, you
  551.         need to catch and respond to these ErrorLevels in the batch file
  552.         that runs EZ-ROM. CD-ROM disks and external doors may be combined
  553.         freely in the same menu. A normal EZ-ROM exit where no door or disk
  554.         is selected is ErrorLevel 0. Internal errors in EZ-ROM exit with
  555.         ErrorLevel 1. Do not set ErrorLevels 1 to 9 as these are reserved
  556.         for future use.
  557.       COLUMN 5 is the full path and file name of the EZROM.CFG used
  558.         for each CD-ROM disk. Create a separate subdirectory for each
  559.         disk. Place all the files for that particular disk in the same
  560.         subdirectory along with the EZROM.CFG for that disk. Column 5
  561.         is blank if this line indicates an external door.
  562.       COLUMN 6 is the disk name. Optional. Must be between double quotes
  563.         as shown. If this column is not used, then the disk name will
  564.         be read from EZROM.CFG. Column 6 is blank if this line
  565.         indicates an external door.
  566.  
  567.  
  568.       Explanation of Disk Detection and the AUTO commands:
  569.  
  570.       Optional. Use of any of the AUTO commands for a disk activates the
  571.       disk detect for that particular disk. EZ-ROM will read the volume
  572.       name of the disk in the drive and set the disk online if the volume
  573.       name matches the disk volume name in EZROM.CFG. If there is no match,
  574.       then the disk will be set to the fallback status of Request, Offline,
  575.       or Closed. The comparison is not case sensitive, but it must be an
  576.       exact match.
  577.  
  578.       The use of this feature is NOT recommended if you run a multi-disk
  579.       changer such as a Pioneer DRM-60X because it will cause each disk to
  580.       swap in and out every time EZ-ROM starts. Disk detect is off by
  581.       default.
  582.  
  583.       To enable Disk Sensing for a disk, you must do TWO things. You must
  584.       use an AUTO command for that disk in the DISKS section of EZROM.MAS,
  585.       and you must place a Volume command in the EZROM.CFG for that disk.
  586.       If a disk is set AUTO, but the volume command does not appear in the
  587.       EZROM.CFG, then the disk volume name will not be read and the disk
  588.       will be set to the fallback status. The auto detect status of each
  589.       disk is independent.
  590.  
  591.       Disk detection is independent of AutoMenu. You can use either, both,
  592.       or neither. If you do use disk detection, then AutoMenu is highly
  593.       recommended so that the menu will always match.
  594.  
  595.       The full list of status commands is:
  596.  
  597.       ON              ( always online )
  598.       REQ             ( always requestable )
  599.       OFF             ( always offline )
  600.       CLO             ( always closed )
  601.       AUTO-REQ        ( online if volume name match, otherwise requestable )
  602.       AUTO-OFF        ( online if volume name match, otherwise offline )
  603.       AUTO-CLOSED     ( online if volume name match, otherwise closed  )
  604.  
  605.       If you have specified a BusyFlag for that disk, then EZ-ROM will look
  606.       for the BusyFlag before trying to access the disk. If the BusyFlag is
  607.       found, EZ-ROM will wait until the flag is erased by the other node.
  608.       And it will create a new BusyFlag for the time it takes to read the
  609.       volume name. The related commands of FlagDelay and DelOldFlag are
  610.       also read and used if you use a BusyFlag.
  611.  
  612.  
  613.    AUTOMENU  ON
  614.    AUTOMENU  OFF
  615.  
  616.       Optional. Choose one. For multi-disk mode only. AutoMenu is OFF by
  617.       default. When AutoMenu is ON then EZ-ROM will automatically construct
  618.       the main disk selection menu of all disks on-the-fly. This menu will
  619.       indicate which disks are online, request, or offline. If you set
  620.       AutoMenu OFF, then EZ-ROM will display the menu files MAIN.CLR or
  621.       MAIN.BBS. If neither of these files are not found, then EZ-ROM will
  622.       automatically switch back to AUTOMENU ON. See the
  623.       AuotMenuTitle/AutoMenuColor commands below for information on
  624.       customizing the AutoMenu display text and colors.
  625.  
  626.  
  627.    VOLUME  NOPV11_194
  628.  
  629.       Optional. For use in EZROM.CFG only. Defines the volume name of the
  630.       disk used for purposes of disk detection. This command is only
  631.       required on those disks defined as AUTO in the DISKS section of
  632.       EZROM.MAS. The volume name for Night Owl 11 is shown. Use the correct
  633.       volume name for your disk. You can get the volume name by using the
  634.       DOS VOL command. DOS limits the volume name to 11 characters. Before
  635.       making the comparison, EZ-ROM automatically strips any spaces and
  636.       periods from both the volume name specified and the volume name read
  637.       from the disk.
  638.  
  639.       Disk scanning is NOT recommended on multi-disk changers because it
  640.       will cause each disk to swap in and out every time EZ-ROM starts.
  641.  
  642.       The simple form of the Volume command is shown above, but there are
  643.       additional options. If you have more than one CD-ROM drive, then you
  644.       may want to use the /SCAN option:
  645.  
  646.       VOLUME  NOPV11_194  /SCAN  EF
  647.  
  648.       This means EZ-ROM will look for the volume name NOPV11_194 on both
  649.       drives E and F. You can scan up to 26 drive letters from A to Z. The
  650.       drives are always scanned in order from A to Z. It will stop scanning
  651.       drives when it reaches the first matching volume name. Once a drive
  652.       letter has been assigned to a disk, that drive letter will not be
  653.       scanned again. If you do not use the /SCAN command, then it will only
  654.       scan the drive letter indicated in the first entry in the left column
  655.       in the AREAS section of EZROM.CFG. The drive letter specified in the
  656.       AREAS section will also be scanned in addition to any drives
  657.       specified using the /SCAN command. If you use the optional CDDRIVE
  658.       command, this drive letter will also be scanned. If the same drive
  659.       letter is specified more than once, it will only be scanned once.
  660.  
  661.       If the CD-ROM disk does not have a volume label, you may want to
  662.       use the option to scan for a specific marker file like this:
  663.  
  664.       VOLUME  E:\GAMES\DOOM2.ZIP
  665.  
  666.       The backslash character "\" must be used. It indicates that EZ-ROM is
  667.       to scan for a specific file and NOT scan for a volume label. If no
  668.       backslash character is used, EZ-ROM will assume that it is a volume
  669.       label. Choose a path and file name unique to that particular disk.
  670.  
  671.       Here is another form of this command:
  672.  
  673.       VOLUME  E:\GAMES\DOOM2.ZIP  /SCAN  EF
  674.  
  675.       In this case, EZ-ROM will look for file E:\GAMES\DOOM2.ZIP and if it
  676.       is not there, it will then look for file F:\GAMES\DOOM2.ZIP. The
  677.       scanning operation is exactly the same except that a specific file
  678.       name is used instead of a volume label. All of the previously defined
  679.       scanning rules apply.
  680.  
  681.       The backslash "\" indicates a specific file name.
  682.       The forward slash "/SCAN" indicates multiple disk scanning.
  683.       Please do not confuse forward slash and backslash.
  684.  
  685.       If you have problems with disk scanning, see command DebugVol.
  686.       Setting this command ON will cause EZ-ROM to log all scanning
  687.       operations and results to file ERROR.LOG.
  688.  
  689.  
  690.    HOLDDIR  C:\CDROM\HOLD
  691.  
  692.       Mandatory. This is the holding directory where the files are copied
  693.       to if CopyToMag is ON. The program also writes the batch download
  694.       file list here in all cases. This list is named EXT1.LST where the 1
  695.       indicates the node number. The program takes care of its own
  696.       housekeeping and deletes the copied files after the download. Just
  697.       the copied files are deleted. Any other files that exist in this
  698.       directory will NOT be deleted. In local mode, the files are also
  699.       copied here and the descriptions are added to a FILES.BBS in this
  700.       subdirectory. If no FILES.BBS exists, one is created. Default is the
  701.       directory specified by HomeDir. If no HoldDir is specified and no
  702.       HomeDir is specified, then the default is the current directory.
  703.  
  704.  
  705.    HOMEDIR  C:\CDROM
  706.  
  707.       Optional. This is the EZ-ROM home directory. In registered versions,
  708.       this is where the request data file EZROM.REQ and the caller database
  709.       EZROM.DAT is created and kept. On multi-node systems, these files can
  710.       (and should) be shared by all nodes if the same HomeDir is specified
  711.       for all nodes. Default is the current directory.
  712.  
  713.  
  714.    REQUESTDIR  C:\CDROM\REQUEST
  715.  
  716.       Registered versions only.
  717.       Mandatory if file requests from offline disks are allowed.
  718.       This is the holding directory where the requested files are held
  719.       after they are copied to the hard drive. The program takes care of
  720.       its own housekeeping and deletes the requested files after the caller
  721.       successfully downloads the files AND exits the door. So if the caller
  722.       fails the download, but EZ-ROM thinks the download was good, the
  723.       files will remain in place until the caller exits EZ-ROM. If EZ-ROM
  724.       thinks the download failed, the files will not be deleted. Just the
  725.       downloaded files are deleted. Any other files that exist in this
  726.       directory will NOT be deleted. If more than one caller has requested
  727.       the same file, the file will not be deleted until all callers have
  728.       downloaded the file.
  729.       Default is the directory specified by HoldDir. If no RequestDir is
  730.       specified and no HoldDir is specified, then the default is the
  731.       current directory.
  732.  
  733.  
  734.    PROTOCOL EXTERNAL
  735.  
  736.       Optional. Registered version only.
  737.       This command turns off the internal protocols and causes the program
  738.       to use external X/Y/Zmodem protocols supplied by the shareware DSZ
  739.       program by Chuck Forsberg of Omen Tech. A copy of DSZ.COM or DSZ.EXE
  740.       must be in the current directory or on your DOS path. I recommend
  741.       the use of the internal protocols which is the default, or you can
  742.       set them explicitly with the command PROTOCOL INTERNAL.
  743.  
  744.  
  745.    DRIVER  UART
  746.    DRIVER  FOSSIL
  747.    DRIVER  DIGIBOARD
  748.  
  749.       Optional. Choose ONE. Default is Driver UART.
  750.       EZ-ROM can use one of 3 different communications drivers:
  751.  
  752.       UART ........ Use the built-in EZ-ROM UART comm driver. This is the
  753.                     standard driver. Most people will use this driver.
  754.                     Port speeds up to 115,200 bps are supported.
  755.  
  756.       FOSSIL ...... Use external Fossil driver. Maximum speed 38400 bps.
  757.                     EZ-ROM has been tested with BNU 1.70 and X00 1.53.
  758.                     The Fossil must be properly configured and loaded in
  759.                     memory. Do not use this command if you run your Fossil
  760.                     faster than 38400. EZ-ROM may appear to work, but it
  761.                     may be unstable. If you run your port at 57600 or
  762.                     115200 then you should use Driver UART.
  763.  
  764.       DIGIBOARD ... Use external DigiBoard comm driver such as XIDOS5.SYS.
  765.                     EZ-ROM works with any of the following DigiBoards:
  766.                     COM/Xi, PC/Xi, PC/Xe. The DigiBoard XIDOS5.SYS device
  767.                     driver or equivalent must be properly configured and
  768.                     loaded in memory. The DigiBoard channel used is the Com
  769.                     number minus 1. So for Com2, EZ-ROM will use channel 1.
  770.                     For Com1, it will use channel 0.
  771.                     Port speeds up to 115,200 bps are supported.
  772.  
  773.  
  774.    DISKNAME  Night Owl 18
  775.  
  776.       Optional. You can specify the disk name using this command in
  777.       EZROM.CFG or you can specify the disk name in the DISKS section of
  778.       EZROM.MAS. If you do both, the disk name in EZROM.MAS will be used.
  779.       The disk name is used in the automenu, local status bar display on
  780.       the top of the screen, and in the door log entries. Default name is
  781.       DISKx where x is the disk number. The first disk listed in the DISKS
  782.       section of EZROM.MAS is disk 1.
  783.  
  784.  
  785.    COPYTOMAG ON
  786.    COPYTOMAG OFF
  787.  
  788.       Optional. Choose one. If CopyToMag ON then files will be copied to
  789.       the magnetic hard drive just before downloading. These files will
  790.       then be erased once the download is completed. If CopyToMag OFF then
  791.       the files will be downloaded directly from the CD-ROM drive.
  792.       CopyToMag ON is strongly recommended for use on multi-disk changers
  793.       on a multi-node system.
  794.       Default is CopyToMag ON.
  795.  
  796.  
  797.    FILEVIEW ON
  798.    FILEVIEW OFF
  799.  
  800.       Optional. Choose one.
  801.       Turns the file viewer ON or OFF.
  802.       Some multi-node systems may want to turn FileView OFF since the
  803.       CD-ROM drive must be read to view a file and this can create a lot of
  804.       traffic. If the BusyFlag option is used (see below), then a busy flag
  805.       is created when a file is viewed and all of the other BusyFlag
  806.       control parameters apply. The busy flag is erased as soon as the
  807.       caller returns from viewing the file. Note that this can tie up the
  808.       drive for the entire time a caller is viewing the file. If busy flags
  809.       are not used, then multiple nodes can simultaneously access the drive
  810.       for both viewing and download purposes. If FileView is OFF, then the
  811.       View option does not appear on the caller menu prompts.
  812.  
  813.       The file viewer will show the internal contents of a ZIP file if the
  814.       file has an extension of .ZIP. Otherwise, the viewer looks at the
  815.       file and if it seems to be a text file (no unprintable characters)
  816.       then the viewer display the text file. The viewer cannot display text
  817.       files within ZIP files. If the viewer gets fooled and a .ZIP is not
  818.       really a ZIP, or a text file is not really a text file, then the
  819.       caller may see a bunch of harmless garbage characters.
  820.       Default is FileView ON.
  821.  
  822.  
  823.    SHARE ON
  824.    SHARE OFF
  825.  
  826.       Optional. Choose one. Turns file sharing and locking ON or OFF.
  827.       If you have more than 1 node, or you want to fill requests while a
  828.       caller is online, then set Share ON. In order for file sharing and
  829.       locking to work, you must use DOS 3.1 or higher, and DOS SHARE.EXE
  830.       must be loaded in your CONFIG.SYS or AUTOEXEC.BAT. If file sharing is
  831.       not required, then set Share OFF. This program will run noticeably
  832.       faster with Share OFF.
  833.       Default is Share OFF.
  834.  
  835.  
  836.    TIMEOUT 180
  837.  
  838.       Optional. This is the caller inactivity timeout delay in SECONDS.
  839.       If no keystrokes are received for this length of time, the door will
  840.       exit and return the caller to the BBS. Timeout only applies when the
  841.       door is run from the BBS. There will be no timeout when run from the
  842.       DOS command line.
  843.       Values from 60 to 600 seconds are allowed.
  844.       Default is 180 seconds (3 minutes).
  845.  
  846.  
  847.    DELAYSECS 10
  848.  
  849.       Optional. This the pause time in seconds for the "Strike any Key To
  850.       Continue" message that appears in many places in the door. The door
  851.       will wait for a keystroke for this number of seconds. If no keystroke
  852.       is received within this time, then the door will proceed to the next
  853.       screen. If some of the display screens pass by too quickly to read,
  854.       then try increasing this number.
  855.       Values from 1 to 3600 seconds are allowed.
  856.       Default is 10 seconds.
  857.  
  858.  
  859.    DEBUG ON
  860.    DEBUG OFF
  861.  
  862.       Optional. Choose one. Most program error conditions are logged to
  863.       ERROR.LOG if Debug is turned on. The program may load a bit faster if
  864.       you turn this off. If you have problems, leave Debug ON.
  865.       Default is Debug ON.
  866.  
  867.  
  868.    DEBUGVOL ON
  869.    DEBUGVOL OFF
  870.  
  871.       Optional. Choose one. Setting this command ON will cause EZ-ROM to
  872.       log all volume label scanning operations and results to file
  873.       ERROR.LOG. If you have disk scanning problems, set this command ON.
  874.       Default is DebugVol OFF.
  875.  
  876.  
  877.    DROPPENALTY 300
  878.  
  879.       Optional. Number of SECONDS to penalize the caller if carrier is
  880.       dropped when in the door. This time will be subtracted from the
  881.       callers time allowed during the next call that day. If the caller
  882.       does not call back until the next day, then this penalty will have no
  883.       effect.
  884.       Values from 0 to 7200 seconds (0 to 120 minutes) are allowed.
  885.       Default is 300 seconds (5 minutes).
  886.  
  887.  
  888.    ALLOWLOGOFF ON
  889.    ALLOWLOGOFF OFF
  890.  
  891.       Optional. If AllowLogOff ON then the caller will be offered the
  892.       option to select unattended automatic logoff after each download.
  893.       Default is AllowLogOff ON.
  894.  
  895.  
  896.    LINESPERPAGE 21
  897.  
  898.       Optional. Determines the number of lines shown for each screen page
  899.       when the caller is scrolling through the file lists, viewing a menu
  900.       screen, or viewing a file. A typical IBM PC clone screen has 25
  901.       lines. But since 2 lines are used at the top for the information bar,
  902.       and 2 lines are used at the bottom for the command prompts, only 21
  903.       lines remain for use by the rest of the display.
  904.       Values from 5 to 22 lines per page are allowed.
  905.       Default is 21 lines per page.
  906.  
  907.    LINESPERFILE 5
  908.  
  909.       Optional. Determines the maximum number of lines shown for each file
  910.       when the caller is scrolling through the file lists, or doing a text
  911.       search. Only applies to files with a multi-line description. Values
  912.       from 1 to (the number of lines per page - 2) are allowed.
  913.       Default is 5 lines per file.
  914.       You can use this command in EZROM.MAS and/or EZROM.CFG. I recommend
  915.       that you set it once in EZROM.MAS as an initial value, and then let
  916.       the caller make any desired changes in the utility menu. If you set a
  917.       value in EZROM.CFG then it will force it to this value every time the
  918.       caller enters that disk.
  919.  
  920.  
  921.    FIXTIME ON
  922.    FIXTIME OFF
  923.  
  924.       Optional. Choose one.
  925.       Controls whether EZ-ROM updates the time on lines 18 and 19 in
  926.       DOOR.SYS or line 12 of DORINFOx.DEF. On some systems, the BBS itself
  927.       calculates the time used in the door and if FixTime is ON the caller
  928.       can be "charged" double the amount of time spent in EZ-ROM when he
  929.       returns to the BBS.
  930.       Default is OFF.
  931.  
  932.  
  933.    TAGCHAR 26 -
  934.  
  935.       Optional. This determines the line position and character used to
  936.       determine which lines in a file list contain a valid file for tagging
  937.       and display purposes.
  938.  
  939.       If you want a tag character to appear on every line in the file list
  940.       then use this command:
  941.  
  942.       TagChar ALL
  943.  
  944.       This is a good choice for lists which do not contain a feasible tag
  945.       character, such as those lists with only a file name and description.
  946.       Do not use this option for lists that have headers or contain any
  947.       lines which are not files.
  948.  
  949.       If you set a specific tag character, then lines which
  950.       contain this exact character at this exact position are colorized and
  951.       assigned a tag letter. Lines which do NOT contain this character at
  952.       this position are assumed to be header lines or extended description
  953.       lines. Default is a dash at position 26 as shown below:
  954.  
  955. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+..
  956. EZROM22.ZIP   220,195  01-14-96  EZ-ROM v2.20, CD-ROM Door by Mike Robinson
  957.                          ^
  958.                          character at position (column) 26 is a dash
  959.  
  960.       Examples of common file formats:
  961.       TagChar 26 -   (tag lines with a dash at position 26) (DEFAULT)
  962.                      (Typically used in Spitfire & Night Owl type lists)
  963.  
  964.       TagChar 28 -   (tag lines with a dash at position 28)
  965.       TagChar 26 /   (tag lines with a forward slash at position 26)
  966.       TagChar 28 /   (tag lines with a forward slash at position 28)
  967.       TagChar 18 ,   (tag lines with a comma at position 18 )
  968.  
  969.       Only one character and position may be designated as the TagChar. If
  970.       multiple TagChar are specified in EZROM.CFG then the last TagChar
  971.       specified is used. For file tagging to work properly, the file name
  972.       must be listed first on each line of the file list (column position
  973.       1 to 12). EZ-ROM is smart enough to recognize the file name even if
  974.       it is "fractured" and not continuous like in these examples:
  975. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+..
  976. FILE1   .ZIP  344,101  01-31-94  A good game
  977. FILE1.   ZIP  344,101  01-31-94  A good game
  978. FILE1    ZIP  344,101  01-31-94  A good game
  979.       The last example is typical of file lists that are created based on
  980.       the DOS DIR command.
  981.  
  982.  
  983.    DELCHAR 32 |
  984.  
  985.       Optional. This sets a line position and a single character that will
  986.       stripped out from every line of a file list. "Night Owl" or "PCBoard"
  987.       style multi-line file lists often have a | character at position 32.
  988.       Use of this command causes the specified character to be replaced by
  989.       a blank in the file list display. The file list itself is not
  990.       modified. In the example shown, on all lines where character | is
  991.       found in position 32, it will be replaced by a blank space.
  992.  
  993.       Only one character and position may be designated as the DelChar. If
  994.       multiple DelChar are specified then only the last DelChar specified is
  995.       used. Any character and any position from 1 to 78 may be used. The
  996.       position is determined by the actual position on the line in the file
  997.       before any display modifications are made by the FileName, FileSize,
  998.       FileDate, FileDesc commands.
  999.  
  1000.       The default is a | at position 32 as shown below:
  1001. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+..
  1002. EZROM22.ZIP   220,195  01-14-96  EZ-ROM v2.20, CD-ROM Door by Mike Robinson
  1003.                                | UART, FOSSIL, DIGIBOARD. Use DOOR.SYS
  1004.                                | or DORINFOx.DEF. Keeps Own Database,
  1005.                                | Enforces Limits, MultiDisk, MultiNode,
  1006.                                | File Tagging, Text Search, Offline
  1007.                                | Requests, ZIP & Text Viewer, Inserts
  1008.                                ^
  1009.                                character at position (column) 32 is a |
  1010.  
  1011.  
  1012.    MULTICHAR  02
  1013.  
  1014.       Optional. Applies only to Spitfire style multi-line formats where the
  1015.       character that marks the beginning of each new line is usually a
  1016.       "smiley face"  (ASCII 02) character. This command allows you to
  1017.       specify the use of a different line marker character instead of the
  1018.       default ASCII 02. If a number from 1 to 255 is specified, then the
  1019.       ASCII equivalent character will be used. If a non-numerical character
  1020.       is specified, then this exact character will be used.
  1021.  
  1022.  
  1023.    STATLINE  TOP  1  14
  1024.  
  1025.       Optional. Default values are shown.
  1026.       TOP means the status line will appear on the top of the screen.
  1027.       The 1 is the background color code (blue). The 14 is the foreground
  1028.       color code (yellow). You can use the command BOTTOM in place of TOP
  1029.       and the line will appear on the bottom of the screen.
  1030.  
  1031.       Background colors from 0 to  7 are allowed.
  1032.       Foreground colors from 0 to 15 are allowed.
  1033.       The color codes are:
  1034.  
  1035.       Black.......... 0       DarkGray....... 8
  1036.       Blue........... 1       LightBlue...... 9
  1037.       Green.......... 2       LightGreen.... 10
  1038.       Cyan........... 3       LightCyan..... 11
  1039.       Red............ 4       LightRed...... 12
  1040.       Magenta........ 5       LightMagenta.. 13
  1041.       Brown.......... 6       Yellow........ 14
  1042.       LightGray...... 7       White......... 15
  1043.  
  1044.  
  1045.  
  1046.    FILENAME    1    12    15
  1047.    FILESIZE   13    10    10
  1048.    FILEDATE   23    11    11
  1049.    FILEDESC   34    45    14
  1050.  
  1051.       Optional. Default values are shown.
  1052.       These 4 configuration commands control how the file lists are
  1053.       displayed. For example:
  1054.  
  1055.       FILENAME    1    12    15
  1056.       This means that the file name starts at line column position 1
  1057.       and is 12 characters long. The 15 is the display color code.
  1058.       The default values are shown above and in this sample line:
  1059. ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
  1060. EZROM22.ZIP   220,195  01-14-96  EZ-ROM v2.20, CD-ROM Door by Mike Robinson
  1061. <---Name---><--Size--><-Date----><-------------Description------------------->
  1062.  
  1063.       The total number of characters displayed by all 4 zones should not
  1064.       exceed 78 or the line display may wrap onto the next line.
  1065.  
  1066.       Colors codes from 9 to 15 are allowed.
  1067.       The color codes are:
  1068.  
  1069.       LightBlue...... 9
  1070.       LightGreen.... 10
  1071.       LightCyan..... 11
  1072.       LightRed...... 12
  1073.       LightMagenta.. 13
  1074.       Yellow........ 14
  1075.       White......... 15
  1076.  
  1077.  
  1078.    HEADLINE    1    78    11
  1079.  
  1080.       Optional. Default values are shown.
  1081.       This command works just like the four above, except it applies to the
  1082.       optional header section at the top of a file list. It means that 78
  1083.       characters will be displayed, starting at character number 1 and the
  1084.       display color will be 11 (Light Cyan).
  1085.       Colors codes from 9 to 15 are allowed.
  1086.  
  1087.  
  1088.    AUTOMENUCOLOR  TOP      12  15
  1089.    AUTOMENUCOLOR  ONLINE   15  14  11  15
  1090.    AUTOMENUCOLOR  REQUEST   7  14   3   7
  1091.    AUTOMENUCOLOR  OFFLINE   7  14   7   7
  1092.  
  1093.       Optional. Default values are shown.
  1094.       These 4 configuration commands control the colors used in the
  1095.       AutoMenu disk selection display screen.
  1096.       AutoMenuColor TOP defines the colors of the title line at the top of
  1097.       the menu. AutoMenuColor ONLINE defines the colors of disks that are
  1098.       online. AutoMenuColor REQUEST defines the colors of disks that are
  1099.       requestable. And so on. The colors are in order as they appear
  1100.       onscreen. So if you use this command
  1101.  
  1102.       AutoMenuColor  ONLINE   15  14  11  15
  1103.  
  1104.       then an online disk will be displayed like this:
  1105.  
  1106.       < 1> ONLINE- Night Owl 18
  1107.  
  1108.       The brackets will be color 15.
  1109.       The 1 will be color 14
  1110.       The ONLINE- will be color 11
  1111.       The Night Owl 18 will be color 15.
  1112.  
  1113.       AutoMenuColor TOP has only 2 colors. The first is the color of the
  1114.       leading/trailing asterisk. The second is the color of the text.
  1115.  
  1116.       The color codes are the same as used in the list displays:
  1117.       Black.......... 0       DarkGray....... 8
  1118.       Blue........... 1       LightBlue...... 9
  1119.       Green.......... 2       LightGreen.... 10
  1120.       Cyan........... 3       LightCyan..... 11
  1121.       Red............ 4       LightRed...... 12
  1122.       Magenta........ 5       LightMagenta.. 13
  1123.       Brown.......... 6       Yellow........ 14
  1124.       LightGray...... 7       White......... 15
  1125.  
  1126.  
  1127.     AUTOMENUTITLE  The title at top of AutoMenu goes here
  1128.  
  1129.       Optional. Registered versions only. Defines the text at the top of
  1130.       the AutoMenu screen. In unregistered versions, the default top line
  1131.       cannot be changed and looks like this:
  1132.  
  1133.       * EZ-ROM - The CD-ROM Door for Any BBS *
  1134.  
  1135.       In the registered version, the default top line looks like this:
  1136.  
  1137.       * "Your BBS Name" - Files On CD-ROM *
  1138.  
  1139.       It replaces the "Your BBS Name" with your actual BBS name which
  1140.       it reads from the registration key file.
  1141.  
  1142.       Use the optional AutoMenuTitle command to define your own title.
  1143.       EZ-ROM automatically puts an asterisk before and after the text you
  1144.       specify with this command.
  1145.  
  1146.  
  1147.    NODOWNLOAD 10 15 20
  1148.  
  1149.       Optional. This sets no download status for listed security levels.
  1150.       You may also use the word ALL in place of the listed levels and then
  1151.       all security levels will not be allowed to download. In the example
  1152.       shown above security levels 10, 15 and 20 are not allowed to
  1153.       download. Up to 20 levels can be set on one NoDownLoad line. Use as
  1154.       many lines as your require, each line beginning with NoDownLoad. If
  1155.       this command is set in EZROM.MAS, then it applies to all disks. If
  1156.       set in EZROM.CFG then it applies to just one disk. The value in
  1157.       EZROM.CFG prevails. Default is downloads allowed.
  1158.  
  1159.  
  1160.    NOREQUEST 10 15 20
  1161.  
  1162.       Optional. Registered versions only.
  1163.       This sets no request status for listed security levels.
  1164.       You may also use the word ALL in place of the listed levels and then
  1165.       all security levels will not be allowed to request files. In the
  1166.       example shown above security levels 10, 15 and 20 are not allowed to
  1167.       request files. Up to 20 levels can be set on one NoRequest line. Use
  1168.       as many lines as your require, each line beginning with NoRequest. If
  1169.       running multi-disk and this command is set in EZROM.MAS, then it
  1170.       applies to all disks. If set in EZROM.CFG then it applies to just one
  1171.       disk. The value in EZROM.CFG prevails. Default is requests allowed.
  1172.  
  1173.  
  1174.    CHECKSIZE ON
  1175.    CHECKSIZE OFF
  1176.  
  1177.       Optional. Choose one. If ON, then the CD-ROM drive will be read
  1178.       during file tagging to determine if the file is actually there and
  1179.       it's size/date. If OFF, then the CD-ROM will not be read during file
  1180.       tagging, and the file size and date will be read from the file list.
  1181.       This will speed up the tagging operation and reduce the load on the
  1182.       CD-ROM drive on multi-node and networked systems. OFF should work
  1183.       well if your file lists have accurate file sizes and are in a format
  1184.       where the size is listed in columns 9 to 21 (default) or in the
  1185.       position specified by the FileSize command. Note that if the file
  1186.       size in the list is wrong, a caller could exceed his daily byte or
  1187.       time limit. If set OFF and a file size cannot be read from the list,
  1188.       then a default size of 50 kilobytes is used. If this command is used
  1189.       in EZROM.MAS, then it applies to all disks. If used in EZROM.CFG, it
  1190.       applies to just one disk. Default is CheckSize ON.
  1191.  
  1192.  
  1193.    GRAPHICS ON
  1194.    GRAPHICS OFF
  1195.  
  1196.       Optional. EZ-ROM will automatically read the graphics mode from
  1197.       file DOOR.SYS line 20 or file DORINFOx.DEF line 10. If using
  1198.       DORINFOx.DEF, then EZ-ROM will start in ANSI mode unless DORINFOx.DEF
  1199.       line number 10 is a 0.
  1200.       This command overrides the value in the file.
  1201.       Graphics ON  forces EZ-ROM to start in ANSI  graphics (Color) mode.
  1202.       Graphics OFF forces EZ-ROM to start in ASCII graphics (B & W) mode.
  1203.  
  1204.  
  1205.    DLTIMER 30
  1206.  
  1207.       Optional. This command only applies to external protocols. It is used
  1208.       in determining whether a download was successful. The default is 30.
  1209.       If a download takes more than 30 percent of the estimated download
  1210.       time, then it is assumed to be successful. Allowable range is from 1
  1211.       to 255. Note that there is no decimal point or percent sign on the
  1212.       command line. Just the number 30 alone means 30 percent. Please
  1213.       consider that setting this too low will result in callers being
  1214.       "charged" for failed downloads. Setting it too high may allow some
  1215.       callers to download without being "charged". Default is 30.
  1216.  
  1217.  
  1218.    LISTDRIVE K
  1219.  
  1220.       Optional. Typically, this will only be used on a network where disk
  1221.       drive letters are reassigned. This command applies to both EZROM.MAS
  1222.       and EZROM.CFG. In EZROM.MAS it changes the drive letter of the path
  1223.       to each EZROM.CFG in the DISKS section. In EZROM.CFG it changes the
  1224.       drive letter of each file list in the AREAS section (right column).
  1225.       It does NOT alter the drive letter of the CD-ROM drive in the AREAS
  1226.       section. No matter what drive letter was actually specified, it is
  1227.       changed to the drive letter following the ListDrive command.
  1228.       Example:
  1229.       I run a 2 node BBS using an Artisoft LANtastic network. Node 1 is
  1230.       drive C. My EZROM.MAS file, all of my EZROM.CFG files, and all of my
  1231.       file lists are on node 1 drive C. In EZROM.MAS all of the paths in
  1232.       the DISKS section begin with the drive letter C. In each EZROM.CFG
  1233.       the path to each file list in the AREAS section begins with the drive
  1234.       letter C. When logged onto node 2, node 1 drive C is remapped to K.
  1235.       So I copied the exact same EZROM.MAS file from node 1 to node 2 and
  1236.       added just one line to it: ListDrive K. So both nodes share the same
  1237.       set of EZROM.CFG files and file lists. But each node has it's own
  1238.       EZROM.MAS file. The only difference between the 2 EZROM.MAS files is
  1239.       that node 2 contains the ListDrive K command. On my BBS, each of my
  1240.       CD-ROM drives uses the same drive letter on all nodes of my network.
  1241.       So CD-ROM drive N is CD-ROM drive N on all nodes. See CDDRIVE command
  1242.       if you need to remap CD-ROM drive letters.
  1243.       If the ListDrive command is used in EZROM.MAS then it will apply to
  1244.       EZROM.MAS and also to ALL of the EZROM.CFG files. If it is used in a
  1245.       EZROM.CFG file then it applies to just that one EZROM.CFG file. In
  1246.       general, I recommend that you only use this command in EZROM.MAS.
  1247.  
  1248.  
  1249.    CDDRIVE F
  1250.  
  1251.       Optional. Typically, this will only be used on a network where disk
  1252.       drive letters are reassigned. This command applies to EZROM.CFG only.
  1253.       It changes the drive letter of each CD-ROM drive directory in the
  1254.       AREAS section (left column). No matter what CD-ROM drive letter was
  1255.       actually specified, it is changed to the drive letter following the
  1256.       CDDrive command.
  1257.       Do NOT use this command in EZROM.MAS since it is would then apply
  1258.       to ALL of your CD-ROM disks and it is very unlikely that they all
  1259.       have the same drive letter.
  1260.  
  1261.  
  1262.    BUSYFLAG C:\CDROM\HOLD\DRIVE1.BSY
  1263.  
  1264.       Optional. This command is NOT required on most systems.
  1265.  
  1266.       It is designed for use with CD-ROM multi-disk changers (such as the
  1267.       Pioneer DRM series) where the same changer is used on 2 or more BBS
  1268.       nodes. If you do not have a multi-disk changer, then you probably
  1269.       do NOT need this command. If you run a single node BBS, then you
  1270.       probably do NOT need this command.
  1271.  
  1272.       This command prevents collisions where more than one caller tries to
  1273.       access the CD-ROM drive at the same time. Most single-disk CD-ROM
  1274.       drives are fast enough to handle this without the use of a busyflag.
  1275.  
  1276.       A semaphore marker file system of collision protection is set by this
  1277.       command. EZ-ROM checks for the existence of this busy flag file
  1278.       before each CD-ROM read. If the file is there, then it waits until
  1279.       the other node erases the file. EZ-ROM creates this file whenever it
  1280.       begins to read from the CD-ROM drive and erases this file when the
  1281.       read is complete. The same busy flag name must be set for each disk
  1282.       that uses the same drive.
  1283.  
  1284.       Default is no busy flag used.
  1285.  
  1286.  
  1287.    FLAGDELAY 30
  1288.  
  1289.       Optional. For use with the BusyFlag command.
  1290.       Sets the maximum time in seconds that the door will wait for a busy
  1291.       CD-ROM drive. In the example above, the door will wait for up to 30
  1292.       seconds before halting the attempted disk read operation and sending
  1293.       a message of "please try again later."
  1294.       Allowable range is 0 to 300 seconds.
  1295.       Default is 30 seconds.
  1296.  
  1297.  
  1298.    DELOLDFLAG 30
  1299.  
  1300.       Optional. For use with the BusyFlag command.
  1301.       When EZ-ROM encounters a busyflag, it checks it's age. If it is older
  1302.       than DELOLDFLAG in minutes, then the flag is deleted. Only the flag
  1303.       declared by the BusyFlag command in the same configuration file is
  1304.       deleted. This is a cleanup feature in case old flags are orphaned by
  1305.       a power failure or other system problem. The default is 30 minutes
  1306.       which means the door will delete any flag older than 30 minutes. The
  1307.       system clocks on a network must be synchronized in order for this
  1308.       command to work properly. It is recommended that you set this value
  1309.       to at least the maximum system time difference between any 2 network
  1310.       nodes. Remember that PC system clocks tend to drift out of
  1311.       synchronization over time.
  1312.       The allowable range is 5 to 720 minutes.
  1313.       Default is 30 minutes.
  1314.  
  1315.  
  1316.    XDISK RUNXDISK.BAT
  1317.  
  1318.       Optional. Registered versions only.
  1319.       This batch file is run BEFORE the files are copied to the hard drive.
  1320.       It is intended for use with XDISK program that can be used to swap
  1321.       disks in some Pioneer CD-ROM multi-disk changers. It is likely that
  1322.       this command will only be required if you use more than one Pioneer
  1323.       drive and have run out of DOS drive letters. But you can use it for
  1324.       any purpose you choose. See the BeforeBat command for a batch file
  1325.       that runs after the files are copied to the hard drive. If you use a
  1326.       BusyFlag then it will be created just prior to executing this batch
  1327.       file. The following DOS variable parameters are passed for use by the
  1328.       batch file:
  1329.  
  1330.       %1  The disk number. The first disk in the DISKS section of EZROM.MAS
  1331.           is disk number 1. The remaining disk numbers are assigned in
  1332.           increasing order to the disks following disk 1.
  1333.       %2  The directory on the hard drive where the files are copied to.
  1334.           There is no tailing backslash.  Example:  %1 = C:\CDROM\HOLD
  1335.       %3  The callers connect speed.  Example: %3 = 14400
  1336.       %4  The port number.  Example %3 = 2
  1337.           If you are using a non-standard port where you have changed the
  1338.           IRQ number or IO base address, then %3 will be the base address
  1339.           followed by a comma followed by the IRQ number. This is the same
  1340.           as used by DSZmodem for non-standard ports.
  1341.           Example:  %3 = 3e8,4   if you are using address 3e8 and IRQ 4.
  1342.       %5  The full path and file name of the list of files being
  1343.           downloaded. This is the holding directory followed by EXT1.LST
  1344.           where the 1 represents the node number as passed on line 4 of
  1345.           DOOR.SYS or as the number represented by x in DORINFOx.DEF. If
  1346.           your holding directory is C:\CDROM\HOLD and you are using node 1
  1347.           then %4 = C:\CDROM\HOLD\EXT1.LST. This same file name is passed
  1348.           to DSZmodem to tell it which files to download when the caller is
  1349.           using Y or Zmodem. If the caller is using Xmodem, then this list
  1350.           is not created.
  1351.  
  1352.       A typical batch file might look like this:
  1353.  
  1354.       XDISK f: %1
  1355.  
  1356.       This runs the XDISK program and assigns the disk number passed in %1
  1357.       to DOS drive letter F. If you use this command in EZROM.MAS then it
  1358.       will apply to all disks. If you use it in EZROM.CFG then it just
  1359.       applies to one disk.
  1360.  
  1361.  
  1362.    DATABASE INTERNAL
  1363.    DATABASE DOORDROPFILE
  1364.    DATABASE COMBINED
  1365.    DATABASE BBSFILE
  1366.  
  1367.       Optional. Registered versions only. Choose one.
  1368.       Registered versions of EZ-ROM keep a separate database of files/bytes
  1369.       requested and downloaded in the door in the EZROM.DAT file. This is
  1370.       fully automatic and cannot be changed. This command determines how
  1371.       this information is used to limit the number of files/bytes
  1372.       downloaded per day:
  1373.  
  1374.       INTERNAL ....... Only the data in EZROM.DAT is used. So only the
  1375.                        files downloaded in EZ-ROM count against the
  1376.                        caller's limits.
  1377.  
  1378.       DOORDROPFILE ... The number of files/bytes downloaded today is read
  1379.                        from DOOR.SYS. The number files/bytes requested
  1380.                        today is read from EZROM.DAT since DOOR.SYS does not
  1381.                        track requests. This command should not be used if
  1382.                        you are using DORINFOx.DEF because DORINFOx.DEF
  1383.                        does not contain any download information.
  1384.  
  1385.       COMBINED ....... This option is not recommended and rarely required.
  1386.                        The number of files/bytes downloaded today read from
  1387.                        DOOR.SYS is added to the number of files/bytes
  1388.                        downloaded today read from EZROM.DAT. The number of
  1389.                        files/bytes requested today is still read from
  1390.                        EZROM.DAT only since DOOR.SYS does not track
  1391.                        requests. This command should not be used if you are
  1392.                        using DORINFOx.DEF because DORINFOx.DEF does not
  1393.                        contain any download information.
  1394.  
  1395.       BBSFILE ........ The number of files/bytes downloaded today is read
  1396.                        from a BBS specific file format. In order for this
  1397.                        to work, you must also use one of the following BBS
  1398.                        specific commands: Wildcat3, Wildcat4, PcBoard,
  1399.                        ExitInfo, Maximus, Tag27. These are separate
  1400.                        commands defined later in this document. The number
  1401.                        files/bytes requested today is read from EZROM.DAT
  1402.                        since the BBS specific files do not track requests.
  1403.  
  1404.       The default is DATABASE DOORDROPFILE.
  1405.  
  1406.       If you run Wildcat, PcBoard, RemoteAccess, ProBoard, Maximus, or TAG,
  1407.       then you should probably use DATABASE BBSFILE and also use one of the
  1408.       following separate BBS specific commands defined later in this
  1409.       document: Wildcat3, Wildcat4, PcBoard, ExitInfo, Maximus, Tag27.
  1410.  
  1411.       For all other BBS types, the best choice is probably DATABASE
  1412.       INTERNAL. The reason for this is that most BBS types do not read back
  1413.       DOOR.SYS. So even though EZ-ROM updates the number of files/bytes
  1414.       downloaded in DOOR.SYS, this information is not saved by the BBS. The
  1415.       caller can re-enter the door several times and download several times
  1416.       his daily limit. The solution is to set DATABASE INTERNAL so the
  1417.       downloads today information is read from EZROM.DAT and the proper
  1418.       limits will be enforced.
  1419.  
  1420.       If you use DORINFOx.DEF and do not use one of the BBS specific
  1421.       files, then you should set DATABASE INTERNAL since DORINFOx.DEF
  1422.       does not contain any download information.
  1423.  
  1424.       The DATABASE COMBINED command should be used if you want the number
  1425.       of files/bytes downloaded today to be calculated as the SUM of the
  1426.       values in DOOR.SYS and EZROM.DAT. In this case, if the caller was
  1427.       allowed 10 downloads per day in EZ-ROM, but had already downloaded 6
  1428.       files in the BBS, then the caller would only be allowed 4 more files
  1429.       in EZ-ROM. In general, the use of Database Combined is NOT
  1430.       recommended.
  1431.  
  1432.       If your BBS does not pass the correct number of files/bytes
  1433.       downloaded in DOOR.SYS or one of the BBS specific files then you
  1434.       should use DATABASE INTERNAL if you want to accurately track and
  1435.       limit daily downloads. The EZ-ROM internal database will work on
  1436.       ANY BBS.
  1437.  
  1438.  
  1439.    KEEPUSERDAYS 90
  1440.  
  1441.       Optional. Registered versions only.
  1442.       This is the number of days a user's information is retained in the
  1443.       internal database file EZROM.DAT. If the user does not call again
  1444.       after this number of days, the user info is not erased, but the
  1445.       record space will be made available for use by another caller. When a
  1446.       new caller exits EZ-ROM, the first available record which is either
  1447.       old or flagged for delete will be overwritten. If no records are older
  1448.       than KeepUserDays or flagged for delete, then a new record is added
  1449.       to the end of the file. This maintenance of the database is automatic
  1450.       and occurs every time a caller enters EZ-ROM. The size of EZROM.DAT
  1451.       will never decrease, but will stabilize at some value where the daily
  1452.       number of new callers roughly equals the number of callers who have
  1453.       not called back within KeepUserDays.
  1454.       Default is 90 days.
  1455.  
  1456.  
  1457.    KEEPREQDAYS 30
  1458.  
  1459.       Optional. Registered versions only.
  1460.       This is the number of days a file request is retained in the request
  1461.       database file EZROM.REQ. If the caller does not download the file
  1462.       within KeepReqDays then the file will be deleted and the request
  1463.       record will be marked DONE. This maintenance is automatic and occurs
  1464.       every time a caller exits EZ-ROM. The next time a file is requested,
  1465.       the first available record marked DONE will be used to record the
  1466.       request. If no records are marked DONE, then a new record will be
  1467.       added to the end of the file. The size of EZROM.REQ will never
  1468.       decrease, but will stabilize at some value where the daily number of
  1469.       new requests roughly equals the number of DONE requests.
  1470.       Default is 30 days.
  1471.  
  1472.  
  1473.    LIMIT   10   12   2000
  1474.  
  1475.       Optional. Registered versions only.
  1476.       EZ-ROM automatically reads the callers allowable limit of download
  1477.       files/bytes from DOOR.SYS. Some may wish to override the DOOR.SYS
  1478.       limits and specify special limits for inside EZ-ROM only. There are
  1479.       no limits in the DORINFOx.DEF file, so you can use this command to
  1480.       set limits if you use DORINFOx.DEF.
  1481.       The 10 is the callers security level.
  1482.       You may also use the word ALL in place of a security level and then
  1483.       the download limit will apply to ALL callers.
  1484.       The 12 is the number files allowed per day.
  1485.       The 2000 is the number of kilobytes per day.
  1486.       So callers with a security level of 10 would be allowed
  1487.       12 files totaling up to 2 meg per day.
  1488.       You can use one line like this for each security level you wish to
  1489.       limit. So if you had security levels of say 10, 20, 30, 40, 50 then
  1490.       your EZROM.MAS might look like this:
  1491.  
  1492.       LIMIT  ALL   12   2000   ( everyone gets 12 files, 2000K )
  1493.       LIMIT   30   14   3000   ( level 30 gets 14 files, 3000K )
  1494.       LIMIT   40   16   4000   ( level 40 gets 16 files, 4000K )
  1495.       LIMIT   50   18   5000   ( level 50 gets 18 files, 5000K )
  1496.  
  1497.       Each limit is tested in the order that they appear in EZROM.CFG. The
  1498.       last limit read that applies to a particular caller will be used. So
  1499.       if you use the ALL command, it should be the first limit specified.
  1500.       In the example above, levels 30, 40, 50 would get the limit defined
  1501.       for their specific level, while all other levels would get the limit
  1502.       defined for ALL.
  1503.  
  1504.       Allowable values are
  1505.       0 to 2000000000 (2 billion) files per day
  1506.       0 to    2000000 (2 million) kilobytes per day.
  1507.  
  1508.       You can also set no limits for all callers using this command:
  1509.  
  1510.       LIMIT  OFF
  1511.  
  1512.  
  1513.    REQLIMIT   10   12   1000
  1514.  
  1515.       Optional. Registered versions only.
  1516.       Works just like the LIMIT command except it limits requests.
  1517.       In the example above, callers with a security level of 10 would
  1518.       be allowed to request up to 12 files per day totaling up to
  1519.       1000 kilobytes (1 megabyte) per day.
  1520.       You may also use the word ALL in place of the security level and then
  1521.       the request limit would apply to ALL callers.
  1522.       Default request limits are the same as the download limits
  1523.       unless request limits are specified using this command.
  1524.       Allowable values are
  1525.       0 to 2000000000 (2 billion) files per day.
  1526.       0 to    2000000 (2 million) kilobytes per day.
  1527.  
  1528.       You can also set no request limits for all callers using this command:
  1529.  
  1530.       REQLIMIT  OFF
  1531.  
  1532.  
  1533.    FILERATIO   10   50
  1534.  
  1535.       Optional. Registered versions only. Sets FILE ratio limits.
  1536.       In the example above, the 10 is the callers security level, and the
  1537.       50 is the ratio to enforce. You may use one of these commands on a
  1538.       separate line to set a separate ratio for each security level. Or,
  1539.       you may use the word ALL in place of a security level and then the
  1540.       ratio will apply to ALL callers. If the caller's download to upload
  1541.       ratio equals or exceeds this amount, the caller will not be allowed
  1542.       any more downloads. This ratio is computed after each successful
  1543.       download by dividing the total number of downloaded files by the
  1544.       total number of uploaded files. For computational purposes, 1 upload
  1545.       is used if the caller has 0 uploads.
  1546.       Allowable ratio values are from 1 to 2000000000 (2 billion).
  1547.       Default is no ratio limits.
  1548.  
  1549.       Be careful with this command. If the number of uploads or downloads
  1550.       supplied to EZ-ROM is not correct, the ratio calculation will
  1551.       not be correct. This could prevent the caller from downloading if
  1552.       EZ-ROM thinks the caller is over the ratio. The information
  1553.       used by EZ-ROM is obtained from different sources depending upon
  1554.       which DATABASE command is used:
  1555.  
  1556.       DataBase Internal ....... Downloads from EZ-ROM database.
  1557.                                 Uploads from DOOR.SYS line 28.
  1558.  
  1559.       DataBase DoorDropFile ... Downloads from DOOR.SYS line 29.
  1560.                                 Uploads from DOOR.SYS line 28.
  1561.  
  1562.       DataBase Combined ....... Downloads from EZ-ROM database and DOOR.SYS.
  1563.                                 Uploads from DOOR.SYS line 28.
  1564.  
  1565.       DataBase BBSFile ........ Downloads from BBS specific file.
  1566.                                 Uploads from BBS specific file.
  1567.  
  1568.       Most, but not all, of the BBS specific files contain the number
  1569.       of uploads and downloads as shown in this chart:
  1570.                                                                 RA/ProBoard
  1571.                           Wildcat3      Wildcat4     PCBoard    ExitInfo
  1572.                           USERINFO.DAT  USERREC.BIN  USERS.SYS  EXITINFO.BBS
  1573.       Files Downloaded ..... YES           YES          YES        YES
  1574.       Files Uploaded  ...... NO            YES          YES        YES
  1575.  
  1576.                           Maximus2      Maximus3      Tag27
  1577.                           LASTUSXX.BBS  LASTUSXX.BBS  USER.LST
  1578.       Files Downloaded ..... NO            YES          YES
  1579.       Files Uploaded  ...... NO            YES          YES
  1580.  
  1581.       If the BBS specific file does not contain the required information,
  1582.       then the information will be read from DOOR.SYS.
  1583.  
  1584.       If you do not use one of the BBS specific commands, and you use
  1585.       DORINFOx.DEF, then do NOT use the FileRatio command. DORINFOx.DEF
  1586.       does not contain any download/upload information and the ratio can
  1587.       not be calculated.
  1588.  
  1589.  
  1590.    BYTERATIO   10   50
  1591.  
  1592.       Optional. Registered versions only. Sets BYTE ratio limits.
  1593.       Works just like the FileRatio except that the ratio is computed based
  1594.       on the number of downloaded to uploaded bytes. The FileRatio and
  1595.       ByteRatio values are independently enforced and can be set to
  1596.       different ratios if desired.
  1597.       Allowable ratio values are from 1 to 2000000000 (2 billion).
  1598.       Default is no ratio limits.
  1599.  
  1600.       Be careful with this command. If the number of uploaded bytes or
  1601.       downloaded
  1602.       bytes supplied to EZ-ROM is not correct, the ratio calculation will
  1603.       not be correct. This could prevent the caller from downloading if
  1604.       EZ-ROM thinks the caller is over the ratio. The information
  1605.       used by EZ-ROM is obtained from different sources depending upon
  1606.       which DATABASE command is used:
  1607.  
  1608.       DataBase Internal ....... Download bytes from EZ-ROM database.
  1609.                                 Upload bytes from DOOR.SYS line 49.
  1610.  
  1611.       DataBase DoorDropFile ... Download bytes from DOOR.SYS line 48.
  1612.                                 Upload bytes from DOOR.SYS line 49.
  1613.  
  1614.       DataBase Combined ....... Download bytes EZ-ROM database and DOOR.SYS.
  1615.                                 Upload bytes from DOOR.SYS line 49.
  1616.  
  1617.       DataBase BBSFile ........ Download bytes from BBS specific file.
  1618.                                 Upload bytes from BBS specific file.
  1619.  
  1620.       Most, but not all, of the BBS specific files contain the number
  1621.       of upload bytes and download bytes as shown in this chart:
  1622.                                                                 RA/ProBoard
  1623.                           Wildcat3      Wildcat4     PCBoard    ExitInfo
  1624.                           USERINFO.DAT  USERREC.BIN  USERS.SYS  EXITINFO.BBS
  1625.       Bytes Downloaded ..... YES           YES          YES        YES
  1626.       Bytes Uploaded  ...... NO            YES          YES        YES
  1627.  
  1628.                           Maximus2      Maximus3      Tag27
  1629.                           LASTUSXX.BBS  LASTUSXX.BBS  USER.LST
  1630.       Bytes Downloaded ..... YES           YES          YES
  1631.       Bytes Uploaded  ...... YES           YES          YES
  1632.  
  1633.       If the BBS specific file does not contain the required information,
  1634.       then the information will be read from DOOR.SYS.
  1635.  
  1636.       If you do not use one of the BBS specific commands, and you use
  1637.       DORINFOx.DEF, then do NOT use the ByteRatio command. DORINFOx.DEF
  1638.       does not contain any download/upload information and the ratio can
  1639.       not be calculated.
  1640.  
  1641.  
  1642.    LOGNAME  C:\BBS\BBS.LOG
  1643.  
  1644.       Optional. Registered versions only. Gives the name of the caller
  1645.       activity log file. Default is BBS.LOG.
  1646.  
  1647.  
  1648.    LOG ON
  1649.    LOG OFF
  1650.  
  1651.       Optional. Registered versions only. Choose one.
  1652.       Turns caller activity log ON or OFF.
  1653.       In unregistered versions the log is forced OFF.
  1654.       In registered versions the default is Log ON.
  1655.       In local mode from the DOS command line the log is always forced OFF.
  1656.  
  1657.  
  1658.    STYLE 1
  1659.    STYLE 2
  1660.  
  1661.       Optional. Registered versions only.
  1662.       Choose one of the style commands shown above. Determines the style of
  1663.       the download line in the caller activity log. Some third party
  1664.       utility programs read the callers log and count or log downloads.
  1665.       These programs require certain download log entry styles which are
  1666.       similar to those created by a normal BBS download.
  1667.       Default is Style 1.
  1668.  
  1669.       Two styles are now offered. More will be added if requested.
  1670.       Only one style may be used in each configuration file. If
  1671.       multiple styles are specified, then the last one specified is
  1672.       used.
  1673.  
  1674.       For Style 1 (Wildcat) a typical log entry looks like this:
  1675.       * File [TETRIS.ZIP] downloaded from (Area 1) via Zmodem
  1676.  
  1677.       For Style 2 a typical log entry looks like this:
  1678.       * 1800LIST.TXT    2,276  Listing of 1-800 BBS systems
  1679.  
  1680.  
  1681.    LOGLEADER  '     * '
  1682.  
  1683.       Optional. Registered versions only.
  1684.       This string of characters between the apostrophes '' is placed in
  1685.       front of each caller activity log entry. The default of 6 spaces,
  1686.       a star, and one space is shown above. The default is designed for
  1687.       Wildcat BBS.
  1688.  
  1689.  
  1690.    INDENTLOG 0
  1691.  
  1692.       Optional. Registered versions only.
  1693.       This is the number of characters each line of the caller activity log
  1694.       will be shifted to the right beyond the amount specified by
  1695.       LogLeader. The line with the caller name (optional, see below)
  1696.       is NOT shifted.
  1697.       The default is 0 as shown above.
  1698.  
  1699.  
  1700.    LOGUSERNAME OFF
  1701.    LOGUSERNAME ON
  1702.  
  1703.       Optional. Registered versions only.
  1704.       If ON, then EZ-ROM writes the caller's name to the caller log.
  1705.       Some may wish to turn this ON if the BBS software does not write the
  1706.       callers name to the same log.
  1707.       Default is OFF.
  1708.  
  1709.  
  1710.    BEFOREBAT COMMENT.BAT
  1711.  
  1712.       Optional. Registered versions only. This batch file is run after the
  1713.       files are copied to the hard drive, but BEFORE the download. I use it
  1714.       to insert a BBS advertisement into each ZIP file, but you can use it
  1715.       for anything you like. See supplied sample file COMMENT.BAT. In the
  1716.       example above, COMMENT.BAT is in the current directory, but a full
  1717.       path and file name may also be specified.
  1718.  
  1719.       The following DOS variable parameters are passed for use by the
  1720.       batch file:
  1721.       %1  The directory on the hard drive where the files are copied to.
  1722.           There is no tailing backslash.  Example:  %1 = C:\CDROM\HOLD
  1723.       %2  The callers connect speed.  Example: %2 = 14400
  1724.       %3  The port number.  Example %3 = 2
  1725.           If you are using a non-standard port where you have changed the
  1726.           IRQ number or IO base address, then %3 will be the base address
  1727.           followed by a comma followed by the IRQ number. This is the same
  1728.           as used by DSZmodem for non-standard ports.
  1729.           Example:  %3 = 3e8,4   if you are using address 3e8 and IRQ 4.
  1730.       %4  The full path and file name of the list of files being
  1731.           downloaded. This is the holding directory followed by EXT1.LST
  1732.           where the 1 represents the node number as passed on line 4 of
  1733.           DOOR.SYS or as the number represented by x in DORINFOx.DEF. If
  1734.           your holding directory is C:\CDROM\HOLD and you are using node 1
  1735.           then %4 = C:\CDROM\HOLD\EXT1.LST. This same file name is passed
  1736.           to DSZmodem to tell it which files to download when the caller is
  1737.           using Y or Zmodem. If the caller is using Xmodem, then this list
  1738.           is not created.
  1739.  
  1740.       Note that if you use a separate holding directory for each node, then
  1741.       only the files being downloaded by the caller will be in this
  1742.       directory. So the batch file can do something to each of the files in
  1743.       this directory. Here is an example, which is the same as in the
  1744.       supplied example file COMMENT.BAT:
  1745.  
  1746.       ZIPCOM  COMMENT.TXT  %1\*.ZIP
  1747.  
  1748.       This puts the BBS advertisement in file COMMENT.TXT into every ZIP
  1749.       file in the holding directory specified by %1. It uses the included
  1750.       free ZipCom program by Mike Robinson to insert the comment.
  1751.       See ZIPCOM.DOC for more info on this program.
  1752.  
  1753.  
  1754.    AFTERBAT YOURFILE.BAT
  1755.  
  1756.       Optional. Registered versions only. This batch file is run just AFTER
  1757.       a download. It is run before the files are erased from the hard
  1758.       drive. You may use this for any purpose. Perhaps some kind of logging
  1759.       function or a bulletin maker could be executed here. In the example
  1760.       above, YOURFILE.BAT is in the current directory, but a full path and
  1761.       file name may also be specified. Send me any good working batch file
  1762.       you write and I will make it available to other EZ-ROM users. The
  1763.       same set of DOS variable parameters passed to BeforeBat (see above)
  1764.       is also passed to AfterBat.
  1765.  
  1766.  
  1767.    DIRECTVIDEO ON
  1768.    DIRECTVIDEO OFF
  1769.  
  1770.       Optional. Choose one. With DirectVideo ON, all local screen writes
  1771.       will done directly to video memory instead of through the BIOS.
  1772.       Default is DirectVideo ON which seems to work fine on most systems.
  1773.  
  1774.  
  1775.    CHECKSNOW ON
  1776.    CHECKSNOW OFF
  1777.  
  1778.       Optional. Choose one. CheckSnow ON enables "snow checking" when using
  1779.       DirectVideo ON. It has no effect if DirectVideo OFF. Some older CGA
  1780.       monitors may requires this. It should not be a problem on most
  1781.       monochrome, EGA or VGA video systems. Some systems may run a bit
  1782.       faster with CheckSnow OFF.
  1783.       Default is CheckSnow OFF.
  1784.  
  1785.  
  1786.    BIOSSCROLL ON
  1787.    BIOSSCROLL OFF
  1788.  
  1789.       Optional. Choose one. If BiosScroll OFF, then a special scrolling
  1790.       routine is used that suppresses snow and flicker on systems with any
  1791.       kind of color graphics. However, BiosScroll ON is a bit faster.
  1792.       Default is BiosScroll ON.
  1793.  
  1794.  
  1795.    MAXBUFF 64000
  1796.  
  1797.       Optional. Determines the maximum file copy buffer size in bytes. Most
  1798.       systems work well with the default value of 64000 bytes. This is the
  1799.       maximum buffer size. The actual buffer is created just before copying
  1800.       a file and is sized to fit within the DOS conventional (low) memory
  1801.       available at that moment. Some networks, CD-ROM drives, and CD-ROM
  1802.       software drivers may give better performance if you reduce the
  1803.       MaxBuff. If you are experiencing a problem when the door copies large
  1804.       files, then try reducing the MaxBuff to 32000 or 16000 bytes. The
  1805.       smaller buffer may be a better match with the other CD-ROM related
  1806.       buffers used in your system.
  1807.       Values from 500 to 65500 bytes are allowed.
  1808.       Default is 64000 bytes.
  1809.  
  1810.  
  1811.    MAXQ 20
  1812.  
  1813.       Optional. Determines the maximum number of files that can be entered
  1814.       at one time in the queue used for downloading, requesting, or copying
  1815.       files.
  1816.       Values from 1 to 20 files are allowed.
  1817.       Default is 20 files.
  1818.  
  1819.  
  1820.    LOCKPORT 19200
  1821.  
  1822.       Optional. Do not use this command unless you are sure you need it.
  1823.       EZ-ROM will automatically read the hardware to determine the port
  1824.       speed to use. Use of this command overrides the automatic speed
  1825.       detection and forces the port to open at the speed indicated.
  1826.       EZ-ROM will attempt to restore the port to it's original speed and
  1827.       state just before EZ-ROM halts and returns control to the BBS.
  1828.       Valid port speeds are: 300, 1200, 2400, 4800, 9600, 19200, 38400,
  1829.       57600, 115200.
  1830.  
  1831.  
  1832.    HANDSHAKE ha cts
  1833.  
  1834.       Optional. This command only applies to external protocols. Sets DSZ
  1835.       external protocol to use CTS hardware handshaking flow control. Note
  1836.       that the command ha cts must be all lowercase since DSZ is case
  1837.       sensitive on virtually all commands.
  1838.  
  1839.  
  1840.    HARDFLOW  ON
  1841.  
  1842.       Optional. Do not use this command unless you are sure you need it.
  1843.       Set HardFlow OFF to turn OFF hardware flow control (RTS/CTS) in
  1844.       EZ-ROM itself. In general, you should leave HardFlow ON. Most modern
  1845.       modems support hardware flow control. If your com port is running
  1846.       faster than your modem link connect rate, then you must use some
  1847.       sort of flow control. Hardware flow control is almost always the
  1848.       best choice, especially for port speeds of 9600 bps or more.
  1849.       Default is HardFlow ON.
  1850.  
  1851.  
  1852.    SOFTFLOW  OFF
  1853.  
  1854.       Optional. Do not use this command unless you are sure you need it.
  1855.       Set SoftFlow ON to turn on software flow control (XON/XOFF) in EZ-ROM
  1856.       itself. In general, Hardware flow control (RTS/CTS) is much better,
  1857.       and most modern modems support it. Software flow control will
  1858.       probably not work very well on a high speed modem. If you use
  1859.       software flow control, please send me a note. I am curious if anyone
  1860.       uses it. It is possible to turn on both hardware and software flow
  1861.       control, but this is not recommended. Default is SoftFlow OFF.
  1862.  
  1863.  
  1864.    FORCECOMPORT 2
  1865.  
  1866.       Optional. Do not use this command unless you are sure you need it.
  1867.       Com port selection is fully automatic based on the value passed by
  1868.       DOOR.SYS or DORINFOx.DEF. Use of this command overrides this value and
  1869.       forces use of the specified com port.
  1870.       Allowable for this command is 1 to 36.
  1871.       Use in EZROM.MAS (or NODEx.CFG) if running multi-disk  mode.
  1872.       Use in EZROM.CFG if running single-disk mode.
  1873.       If specified in both, only the value in EZROM.MAS is used.
  1874.  
  1875.  
  1876.    FORCEIRQ 3
  1877.  
  1878.       Optional. Do not use this command unless you are sure you need it.
  1879.       The IRQ number selection is fully automatic based on the
  1880.       standard IBM PC values associated with the selected com port
  1881.       number. Use of this command overrides this value and forces use
  1882.       of the specified IRQ number.
  1883.       Allowable for this command is any value from 0 to 15.
  1884.       Use in EZROM.MAS (or NODEx.CFG) if running multi-disk  mode.
  1885.       Use in EZROM.CFG if running single-disk mode.
  1886.       If specified in both, only the value in EZROM.MAS is used.
  1887.  
  1888.  
  1889.    FORCEBASE $02F8
  1890.  
  1891.       Optional. Do not use this command unless you are sure you need it.
  1892.       I/O port base address selection is fully automatic based on
  1893.       the standard IBM PC values associated with the selected com
  1894.       port number. Use of this command overrides this value and forces
  1895.       use of the specified I/O port base address. The $ indicates
  1896.       that the address is specified as a hexadecimal number.
  1897.       Allowable for this command is any value from $0000 to $FFFF.
  1898.       Please note that no checking is done on this value and it
  1899.       is entirely possible to specify a non-existent base address.
  1900.       Use in EZROM.MAS (or NODEx.CFG) if running multi-disk  mode.
  1901.       Use in EZROM.CFG if running single-disk mode.
  1902.       If specified in both, only the value in EZROM.MAS is used.
  1903.  
  1904.  
  1905. ----- BBS SPECIFIC FILES ------------------------------------------------
  1906.  
  1907.       EZ-ROM can read and write BBS specific files for Wildcat 3.x & 4.x,
  1908.       PCBoard, RemoteAccess, ProBoard, Maximus 2.x & 3.x, and TAG. If you
  1909.       use one of the following BBS specific commands, then it will write
  1910.       the number of files/bytes downloaded in EZ-ROM to the BBS specific
  1911.       file. The BBS then reads back the file and updates the number of
  1912.       files/bytes downloaded in the BBS caller database.
  1913.  
  1914.       EZ-ROM reads and writes the caller download statistics in these
  1915.       files. It does not read or write any of the other information. EZ-ROM
  1916.       still requires DOOR.SYS or DORINFOx.DEF to get the rest of the
  1917.       information (such as com port number) even when a BBS specific file
  1918.       is used. The DOOR.SYS or DORINFOx.DEF to use is specified as the
  1919.       second parameter on the command line in the batch file that runs
  1920.       EZ-ROM.
  1921.  
  1922.       The BBS specific files are only updated when the door is used by a
  1923.       remote caller. They are NOT updated when run in either local mode in
  1924.       the BBS, or local mode from the DOS command line.
  1925.  
  1926.       If the file does not exist, or if it is the wrong size, or if it
  1927.       contains the wrong user name, it will not be read or written and an
  1928.       error message will be written to ERROR.LOG.
  1929.  
  1930.       If you use one of the BBS specific commands, then EZ-ROM always
  1931.       WRITES the download statistics to the BBS specific files when the
  1932.       caller exits EZ-ROM and returns to the BBS. If you want EZ-ROM to
  1933.       also READ the BBS specific file when EZ-ROM starts, then you must
  1934.       also use the DATABASE BBSFILE command. (See DataBase command defined
  1935.       in section Configuration Commands above).
  1936.  
  1937.       Please note that you can NOT use DOS % variable parameters in
  1938.       EZROM.MAS or EZROM.CFG. If run multiple nodes, then you should put
  1939.       the BBS specific command in the NODEx.CFG file for each node. (See
  1940.       section MultiNode Operation). If you run a single node BBS, then
  1941.       place the BBS specific command in EZROM.MAS. If you run EZ-ROM in
  1942.       single disk mode and also run a single node BBS, then place the BBS
  1943.       specific command in EZROM.CFG.
  1944.  
  1945.       Here are the fields read/written in each BBS specific file type:
  1946.  
  1947.                           Wildcat3      Wildcat4     PCBoard    RA/ProBoard
  1948.                           USERINFO.DAT  USERREC.BIN  USERS.SYS  EXITINFO.BBS
  1949. Files Downloaded Today ... NO            YES          NO         NO
  1950. Bytes Downloaded Today ... NO            YES          YES        YES
  1951. Files Downloaded Total ... YES           YES          YES        YES
  1952. Bytes Downloaded Total ... YES           YES          YES        YES
  1953. Files Uploaded Total ..... NO            YES          YES        YES
  1954. Bytes Uploaded Total ..... NO            YES          YES        YES
  1955.  
  1956.                           Maximus 2     Maximus 3     TAG
  1957.                           LASTUSXX.BBS  LASTUSXX.BBS  USER.LST
  1958. Files Downloaded Today ... NO            YES           NO
  1959. Bytes Downloaded Today ... YES           YES           NO
  1960. Files Downloaded Total ... NO            YES           YES
  1961. Bytes Downloaded Total ... YES           YES           YES
  1962. Files Uploaded Total ..... NO            YES           YES
  1963. Bytes Uploaded Total ..... YES           YES           YES
  1964.  
  1965.  
  1966.       The definition of each BBS specific command is as follows:
  1967.  
  1968.  
  1969.    WILDCAT4   C:\WILDCAT\WCWORK\NODE1\USERREC.BIN
  1970.  
  1971.       Optional. Registered version only. For WILDCAT 4.x BBS ONLY.
  1972.       The file size of USERREC.BIN must be EXACTLY 733 bytes.
  1973.       Give the full path and file name of the Wildcat 4.x USERREC.BIN file.
  1974.       When a caller exits EZ-ROM, the number of files/bytes downloaded is
  1975.       written to this file. Wildcat then reads this file and updates the
  1976.       Wildcat database. The USERREC.BIN file is only updated when the door
  1977.       is used by a remote caller. The file is NOT updated when run in
  1978.       either local mode in the BBS, or local mode from the DOS command
  1979.       line. If you also use the command DataBase BBSFile, the caller
  1980.       download statistics will also be read from this file when EZ-ROM
  1981.       starts. If the file does not exist, or if it is the wrong size, or if
  1982.       it contains the wrong user name, it will not be read or written.
  1983.  
  1984.       Please note that you can NOT use DOS % variable parameters in
  1985.       EZROM.MAS or EZROM.CFG. If run multiple nodes, then you should put
  1986.       this WILDCAT4 command in the NODEx.CFG file for each node. (See
  1987.       section MultiNode Operation). Please also note that EZ-ROM still
  1988.       requires DOOR.SYS or DORINFOx.DEF even when USERREC.BIN is used. The
  1989.       DOOR.SYS or DORINFOx.DEF to use is specified as the second parameter
  1990.       on the command line in the batch file that runs EZ-ROM. (This command
  1991.       was renamed. The old command name USERREC can still be used.)
  1992.  
  1993.  
  1994.    WILDCAT3   C:\WC30\WCWORK\NODE1\USERINFO.DAT
  1995.  
  1996.       Optional. Registered version only. For WILDCAT 3.x BBS ONLY.
  1997.       USERINFO.DAT must be a text file with EXACTLY 18 lines.
  1998.       Give the full path and file name of the Wildcat 3.x USERINFO.DAT file.
  1999.       When a caller exits EZ-ROM, the number of files/bytes downloaded is
  2000.       written to this file. Wildcat then reads this file and updates the
  2001.       Wildcat database. The USERINFO.DAT file is only updated when the door
  2002.       is used by a remote caller. The file is NOT updated when run in
  2003.       either local mode in the BBS, or local mode from the DOS command
  2004.       line. If you also use the command DataBase BBSFile, the caller
  2005.       download statistics will also be read from this file when EZ-ROM
  2006.       starts. If the file does not exist, or if it has the wrong number of
  2007.       lines, or if it contains the wrong user name, it will not be read or
  2008.       written.
  2009.  
  2010.       Please note that you can NOT use DOS % variable parameters in
  2011.       EZROM.MAS or EZROM.CFG. If run multiple nodes, then you should put
  2012.       this WILDCAT3 command in the NODEx.CFG file for each node. (See
  2013.       section MultiNode Operation). Please also note that EZ-ROM still
  2014.       requires DOOR.SYS or DORINFOx.DEF even when USERINFO.DAT is used. The
  2015.       DOOR.SYS or DORINFOx.DEF to use is specified as the second parameter
  2016.       on the command line in the batch file that runs EZ-ROM. (This command
  2017.       was renamed. The old command name USERINFO can still be used.)
  2018.  
  2019.  
  2020.    PCBOARD   C:\PCB\USERS.SYS
  2021.  
  2022.       Optional. Registered version only. For PCBOARD BBS ONLY.
  2023.       The file size of USERS.SYS must be greater than 257 bytes.
  2024.       Give the full path and file name of the PCBoard USERS.SYS file. Use
  2025.       the correct path for your system. PCBoard creates this file in the
  2026.       current directory. To cause PCBoard to create a USERS.SYS file you
  2027.       must go into PCBoard PCBSETUP and set USERS.SYS to "Y". You should
  2028.       also set DOOR.SYS to "Y" because EZ-ROM still requires DOOR.SYS even
  2029.       when USERS.SYS is used. When a caller exits EZ-ROM, the number of
  2030.       files/bytes downloaded is written to this file. PCBoard then reads
  2031.       this file and updates the PCBoard database. The file is only updated
  2032.       when the door is used by a remote caller. The file is NOT updated
  2033.       when run in either local mode in the BBS, or local mode from the DOS
  2034.       command line. If you also use the command DataBase BBSFile, the
  2035.       caller download statistics will also be read from this file when
  2036.       EZ-ROM starts. If the file does not exist, or if it is the wrong
  2037.       size, or if it contains the wrong user name, it will not be read or
  2038.       written.
  2039.  
  2040.       Please note that you can NOT use DOS % variable parameters in
  2041.       EZROM.MAS or EZROM.CFG. If run multiple nodes, then you should put
  2042.       this PCBOARD command in the NODEx.CFG file for each node. (See
  2043.       section MultiNode Operation). Please also note that EZ-ROM still
  2044.       requires DOOR.SYS or DORINFOx.DEF even when USERS.SYS is used. The
  2045.       DOOR.SYS or DORINFOx.DEF to use is specified as the second parameter
  2046.       on the command line in the batch file that runs EZ-ROM. (This command
  2047.       was renamed. The old command name USERSSYS can still be used.)
  2048.  
  2049.  
  2050.    EXITINFO  C:\RA\NODE1\EXITINFO.BBS
  2051.  
  2052.       Optional. Registered version only. For RemoteAccess, ProBoard, or any
  2053.       BBS using EXITINFO.BBS. EZ-ROM reads and writes the RA 2.xx style
  2054.       EXITINFO.BBS. The file size of EXITINFO.BBS must be EXACTLY 2363
  2055.       bytes. Give the full path and file name of the EXITINFO.BBS file.
  2056.       When a caller exits EZ-ROM, the number of files/bytes downloaded is
  2057.       written to this file. The BBS then reads this file and updates the
  2058.       BBS database. The EXITINFO.BBS file is only updated when the door is
  2059.       used by a remote caller. The file is NOT updated when run in either
  2060.       local mode in the BBS, or local mode from the DOS command line. If
  2061.       you also use the command DataBase BBSFile, the caller download
  2062.       statistics will also be read from this file when EZ-ROM starts. If
  2063.       the file does not exist, or if it is the wrong size, or if it
  2064.       contains the wrong user name, it will not be read or written.
  2065.  
  2066.       Please note that you can NOT use DOS % variable parameters in
  2067.       EZROM.MAS or EZROM.CFG. If run multiple nodes, then you should put
  2068.       this EXITINFO command in the NODEx.CFG file for each node. (See
  2069.       section MultiNode Operation). Please also note that EZ-ROM still
  2070.       requires DOOR.SYS or DORINFOx.DEF even when EXITINFO.BBS is used. The
  2071.       DOOR.SYS or DORINFOx.DEF to use is specified as the second parameter
  2072.       on the command line in the batch file that runs EZ-ROM.
  2073.  
  2074.  
  2075.    MAXIMUS   C:\MAX\NODE1\LASTUS01.BBS
  2076.  
  2077.       Optional. Registered version only. For MAXIMUS 2.xx and 3.xx BBS ONLY.
  2078.       The file size of LASTUSxx.BBS must be either 240 bytes for Maximus 2,
  2079.       or 460 bytes for Maximus 3. EZ-ROM will use the correct Maximus
  2080.       format based on the size of the file. Give the full path and file
  2081.       name of the LASTUSXX.BBS file. When a caller exits EZ-ROM, the number
  2082.       of files/bytes downloaded is written to this file. Maximus then reads
  2083.       this file and updates the Maximus database. The LASTUSXX.BBS file is
  2084.       only updated when the door is used by a remote caller. The file is
  2085.       NOT updated when run in either local mode in the BBS, or local mode
  2086.       from the DOS command line. If you also use the command DataBase
  2087.       BBSFile, the caller download statistics will also be read from this
  2088.       file when EZ-ROM starts. If the file does not exist, or if it is the
  2089.       wrong size, or if it contains the wrong user name, it will not be
  2090.       read or written.
  2091.  
  2092.       Please note that you can NOT use DOS % variable parameters in
  2093.       EZROM.MAS or EZROM.CFG. If run multiple nodes, then you should put
  2094.       this MAXIMUS command in the NODEx.CFG file for each node. (See
  2095.       section MultiNode Operation). Please also note that EZ-ROM still
  2096.       requires DOOR.SYS or DORINFOx.DEF even when LASTUSxx.BBS is used. The
  2097.       DOOR.SYS or DORINFOx.DEF to use is specified as the second parameter
  2098.       on the command line in the batch file that runs EZ-ROM.
  2099.  
  2100.  
  2101.    TAG27  C:\TAG\USER.LST
  2102.  
  2103.       Optional. Registered version only. For TAG 2.7 BBS ONLY.
  2104.       WARNING!  EZ-ROM writes DIRECTLY to the TAG user file USER.LST.
  2105.       EZ-ROM gets the caller record number from DOOR.SYS (or DORINFx.DEF)
  2106.       and then reads this record from USER.LST. If the user name in USER.LST
  2107.       does not exactly match the user name in DOOR.SYS (or DORINFOx.DEF)
  2108.       then it will NOT write to this file. This is a safety precaution.
  2109.       EZ-ROM assumes a TAG 2.7 record size of 585 bytes per user. If
  2110.       this record size is different in a past or future version of TAG,
  2111.       then the names will not match. Even so, it would be wise to BACKUP
  2112.       your USER.LST before you run this program.
  2113.  
  2114.       Give the full path and file name of the USER.LST file. When a caller
  2115.       exits EZ-ROM, the number of files/bytes downloaded is written
  2116.       directly to the caller record in USER.LST. The USER.LST file is only
  2117.       updated when the door is used by a remote caller. The file is NOT
  2118.       updated when run in either local mode in the BBS, or local mode from
  2119.       the DOS command line. If you also use the command DataBase BBSFile,
  2120.       the caller download statistics will also be read from this file when
  2121.       EZ-ROM starts. If the file does not exist, or if it is not named
  2122.       USER.LST, or if it is the wrong size (See also TagSizeCheck command),
  2123.       or if it contains the wrong user name, it will not be read or
  2124.       written.
  2125.  
  2126.       Please note that you can NOT use DOS % variable parameters in
  2127.       EZROM.MAS or EZROM.CFG. If run multiple nodes, then you should put
  2128.       this TAG27 command in the NODEx.CFG file for each node. (See section
  2129.       MultiNode Operation). Please also note that EZ-ROM still requires
  2130.       DOOR.SYS or DORINFOx.DEF even when USER.LST is used. The DOOR.SYS or
  2131.       DORINFOx.DEF to use is specified as the second parameter on the
  2132.       command line in the batch file that runs EZ-ROM.
  2133.  
  2134.  
  2135.    TAGSIZECHECK  ON
  2136.  
  2137.       This command only applies to TAG BBS and is used with the TAG27
  2138.       command. It is a safety feature. Since each TAG 2.7 user record
  2139.       should be exactly 585 bytes, the total size of the TAG USER.LST
  2140.       file should be an exact multiple of 585. If the file is the wrong
  2141.       size, then EZ-ROM will not write to the file. Setting this
  2142.       command to TagSizeCheck OFF disables this safety feature.
  2143.  
  2144.  
  2145. ----- DISPLAY FILES -----------------------------------------------------
  2146.  
  2147.       In multi-disk mode, you can optionally set AutoMenu OFF and then the
  2148.       following display files may be used to show the list of available
  2149.       disks:
  2150.  
  2151.       ANSI                  ASCII
  2152.       -----------           -----------
  2153.       MAINxxx.CLR           MAINxxx.BBS
  2154.       MAINxxx.BBS           MAIN.BBS
  2155.       MAIN.CLR
  2156.       MAIN.BBS
  2157.  
  2158.       The "xxx" shown above represents a security level. For example,
  2159.       MAIN10.CLR is the ANSI menu for security level 10. EZ-ROM
  2160.       searches for the display files in the order indicated above.
  2161.       If specific display files are not found for the caller's
  2162.       security level, then the general MAIN.CLR/BBS files are shown.
  2163.  
  2164.       In both single-disk mode and multi-disk mode, the following
  2165.       display files may be used to show the list of available
  2166.       file areas on a specific disk:
  2167.  
  2168.       ANSI                  ASCII
  2169.       -----------           -----------
  2170.       DISKxxx.CLR           DISKxxx.BBS
  2171.       DISKxxx.BBS           DISK.BBS
  2172.       DISK.CLR
  2173.       DISK.BBS
  2174.  
  2175.       The "xxx" shown above represents a security level. For example,
  2176.       DISK150.BBS is the ASCII menu for security level 150. EZ-ROM
  2177.       searches for the display files in the order indicated above.
  2178.       If specific display files are not found for the caller's
  2179.       security level, then the general DISK.CLR/BBS files are shown.
  2180.  
  2181.  
  2182.       - MULTI-PAGE MENUS -
  2183.  
  2184.       You can also create a multi-page MAIN.CLR/BBS and/or DISK.CLR/BBS. In
  2185.       this case, put all the pages in one file. The door will pause at the
  2186.       end of each page and allow the caller to select a command or scroll
  2187.       to the next page. The number of lines shown is set by the
  2188.       LinesPerPage command.
  2189.  
  2190.       A good method for creating multi-page ANSI menus is to create each
  2191.       page separately in an ANSI editor such as TheDraw. Then use the DOS
  2192.       COPY command to join the screens like this:
  2193.  
  2194.       COPY  PAGE1.CLR+PAGE2.CLR+PAGE3.CLR  ALLPAGES.CLR
  2195.  
  2196.  
  2197.       - CUSTOM WELCOME and GOODBYE SCREENS -
  2198.  
  2199.       Optional. Place these screens in the EZ-ROM home directory.
  2200.       If they exist, they will be displayed to the caller.
  2201.       If registered, WELCOME.CLR or WELCOME.BBS will be displayed prior to
  2202.       entering EZ-ROM. GOODBYE.CLR or GOODBYE.BBS will be displayed after a
  2203.       download if the caller selects log off after transfer.
  2204.       The .CLR file will be shown if the caller is in ANSI graphics mode.
  2205.       The .BBS file will be shown if the caller is in ASCII graphics mode.
  2206.  
  2207.  
  2208. ----- LOCAL KEYBOARD CONTROLS -------------------------------------------
  2209.  
  2210.       ALT C --- Chat Mode On/Off
  2211.       ALT D --- Drop To DOS (local sysop only)
  2212.       ALT J --- Drop To DOS (local sysop only)
  2213.       F6 ------ Take Five Minutes From Caller
  2214.       F7 ------ Give Five Minutes To Caller
  2215.       F10 ----- Exit The Door
  2216.       ALT F1 -- Exit The Door
  2217.       ALT F2 -- Exit The Door
  2218.       ALT K --- Kill. Throw the caller off the BBS *NOW*
  2219.  
  2220.  
  2221. ----- STATUS SCREENS ----------------------------------------------------
  2222.  
  2223.       The status information shown on the local monitor varies according
  2224.       to the mode and comm driver in use:
  2225.  
  2226. For DOS Local Mode:
  2227. DOS Local Mode              Sunday  January 14, 1996                     02:20am
  2228. EZ-ROM 2.20      For Any BBS - Uart, Fossil, or DigiBoard.   Mem Available: 258K
  2229.  
  2230. For Local Mode in the BBS:
  2231. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  2232. EZ-ROM 2.20                           Node:1                                258K
  2233.  
  2234. Online Mode - DigiBoard:
  2235. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  2236. EZ-ROM 2.20          DIGIBOARD      Com2      Node:1      14400E            258K
  2237.  
  2238. Online Mode - Fossil:
  2239. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  2240. EZ-ROM 2.20             FOSSIL      Com2      Node:1      14400E            258K
  2241.  
  2242. Online Mode - Uart:
  2243. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  2244. EZ-ROM 2.20       16550A UART  COM2  Node:1  38400/14400E  IRQ:3  IO:02F8   258K
  2245.  
  2246. Online Mode - when in a particular disk
  2247. Michael Robinson     Shelton CT     203-922-1794     3/10     Sec:10      60 Min
  2248. Night Owl 18 - Online                       COM2   Node:1    38400/14400E   258K
  2249.  
  2250.       Michael Robinson --- Caller name.
  2251.       Shelton CT --------- Caller address.
  2252.       203-922-1794 ------- Caller phone number.
  2253.       3/10 --------------- The caller has downloaded 3 files.
  2254.                            The caller is allowed to download up to 10 files.
  2255.       Sec:10 ------------- Caller security level number is 10.
  2256.       60 Min ------------- The number of minutes caller has left in door.
  2257.  
  2258.       EZ-ROM 2.20 -------- Program name and version number.
  2259.       16550A ------------- UART type detected.
  2260.       UART --------------- UART comm driver in use.
  2261.       FOSSIL ------------- FOSSIL comm driver in use.
  2262.       DIGIBOARD ---------- DigiBoard comm driver in use.
  2263.  
  2264.       COM2 --------------- The Com port number.
  2265.       Node:1 ------------- The BBS node number.
  2266.       38400/14400E ------- Port speed / Caller connect speed.
  2267.                            Caller connect speed has E if error correction.
  2268.       IRQ:3 -------------- Interrupt number.
  2269.       IO:02F8 ------------ IO port base address as a hexadecimal number.
  2270.       258K --------------- Current memory available after loading EZ-ROM.
  2271.  
  2272.       Night Owl 18 - The current CD-ROM disk name.
  2273.       Online ------- The current CD-ROM disk status is Online.
  2274.       OffLine ------ The current CD-ROM disk status is OffLine.
  2275.       Request ------ The current CD-ROM disk status is Requests Allowed.
  2276.  
  2277.       The UART type, port speed, IRQ, and IO address are not displayed
  2278.       when using the Fossil or DigiBoard comm drivers.
  2279.  
  2280.       Here is a typical set of status information that is displayed on the
  2281.       top of the local monitor during a download:
  2282.  
  2283. Download Today.........3  Download KByte Today.......350   BBS Logon: 8:15 pm
  2284. Download Limit........10  Download KByte Limit......2000  Enter Door: 8:21 pm
  2285. Download Total........27  Download KByte Total..... 4512    Begin DL: 8:33 pm
  2286.   Upload Total.........5    Upload KByte Total......1050   Time Left: 33 min
  2287.  
  2288.  
  2289. ----- NOTES -------------------------------------------------------------
  2290.  
  2291.       1. If you use DOOR.SYS then EZ-ROM reads all required BBS information
  2292.          from DOOR.SYS, so it will work fine on any BBS type that can
  2293.          create this file. This is generally thought of as the "standard"
  2294.          door file. Some systems (Wildcat, Spitfire, RBBS, GAP, PCBoard,
  2295.          and others) can generate DOOR.SYS directly, others may require a
  2296.          conversion program. When EZ-ROM terminates (for any reason) it
  2297.          writes an updated version of DOOR.SYS, so if your BBS reads
  2298.          DOOR.SYS on return from a door, the caller information will be
  2299.          updated. TriBBS 10.x reads back DOOR.SYS. I think GAP BBS also
  2300.          reads back DOOR.SYS. If your BBS does not read back DOOR.SYS then
  2301.          you may be able to find a 3rd party converter program that reads
  2302.          the updated DOOR.SYS and then updates the BBS database. Please
  2303.          send me any such converters you find and I will post them on my
  2304.          BBS for other EZ-ROM users. I currently have one such a utility
  2305.          for RoboBoard BBS.
  2306.  
  2307.          EZ-ROM reads and writes the standard 52 line DOOR.SYS. It will
  2308.          also read and write a DOOR.SYS with any number of lines less than
  2309.          52. If it reads a DOOR.SYS with only 32 lines, then it will write
  2310.          a DOOR.SYS with 32 lines.
  2311.  
  2312.          In addition to DOOR.SYS, EZ-ROM also writes to many BBS specific
  2313.          formats if you use any one of the following commands: Wildcat3,
  2314.          Wildcat4, PcBoard, ExitInfo, Maximus, Tag27. If you use one of
  2315.          these commands, then EZ-ROM will update the appropriate BBS
  2316.          specific file. The BBS then reads back this file and the BBS
  2317.          updates the BBS database with the new user download information.
  2318.  
  2319.          EZ-ROM can also run well with a DORINFOx.DEF file. But if you use
  2320.          DORINFOx.DEF then it will not be possible to pass any information
  2321.          back to the BBS since DORINFOx.DEF does not contain any of the
  2322.          required information.
  2323.  
  2324.       2. Testing here on my system shows that the ASCII text file list
  2325.          search routines in EZ-ROM are several times faster than searches
  2326.          of a compiled database and index file. The text file lists also
  2327.          take up about 1/3 as much space as a compiled database. In most
  2328.          cases, the text file lists as supplied on each CD-ROM disk can
  2329.          be used directly with no modification. If space is limited, you
  2330.          do not have to copy these files to your hard drive. EZ-ROM can
  2331.          read them right off the CD-ROM if so configured.
  2332.  
  2333.  
  2334. ----- TROUBLESHOOTING AND GETTING HELP ----------------------------------
  2335.  
  2336.       First, check the included EZ-HELP.TXT file. Many common problems
  2337.       and solutions are discussed there.
  2338.  
  2339.       EZ-ROM writes error conditions to file ERROR.LOG in the current
  2340.       directory. Check this file. If it says that EZ-ROM cannot find or
  2341.       read a certain file, check your EZROM.MAS, EZROM.CFG, and batch files
  2342.       to locate where this file is specified. Change the path to the file
  2343.       or relocate the file. Make sure you set Debug ON (the default) so
  2344.       that errors are written to ERROR.LOG. If you are having problems with
  2345.       disk volume label sensing, set DebugVol ON.
  2346.  
  2347.       If you use a Fossil or DigiBoard driver, make sure it is properly
  2348.       loaded in memory and activated before running EZ-ROM. Check the local
  2349.       monitor status line to see if the comm driver used by EZ-ROM is the
  2350.       driver you set in EZROM.MAS.
  2351.  
  2352.       EZ-ROM should work OK with multiport IO cards that use a shared IRQ.
  2353.       For an intelligent DigiBoard (or compatible) set Driver DigiBoard.
  2354.       All other multiport IO cards should use Driver Uart.
  2355.  
  2356.       The most common problem is a failure to open the com port. If you see
  2357.       EZ-ROM appear on the local screen, but see nothing on the remote end,
  2358.       then you are using the wrong port, the wrong EZ-ROM comm Driver, the
  2359.       selected comm driver is not loaded in memory, or you have a
  2360.       non-standard port. See the included file EZ-HELP.TXT for more
  2361.       information on solving this problem.
  2362.  
  2363.       If you have checked the files above and are still experiencing
  2364.       problems, then please pack the following files into one ZIP file and
  2365.       upload it to my BBS:
  2366.  
  2367.       1. A text file describing the problem.
  2368.       2. Any ERROR.LOG files created by EZ-ROM.
  2369.       3. EZROM.MAS and EZROM.CFG
  2370.       4. The batch file that runs EZ-ROM.
  2371.       5. DOOR.SYS or DORINFOx.DEF
  2372.  
  2373.       Sending the problem description as a text file will save you online
  2374.       time and phone charges. It also helps me to have the problem
  2375.       description and related files all in one neat package.
  2376.  
  2377.       I will post a reply message on my BBS for you within 24 hours.
  2378.       FidoNet nodes may netmail the same information, and I will reply via
  2379.       direct netmail. I fully support both registered and unregistered
  2380.       versions. This program runs well on hundreds of systems, and I will
  2381.       work with you to get it working on your BBS. I recently opened node 2
  2382.       (203-922-1794  FidoNet 1:141/486) which is dedicated exclusively to
  2383.       handling support for my shareware. Traffic on this node is very
  2384.       light, and it is almost always ready and waiting for callers.
  2385.  
  2386.  
  2387. ------- REGISTRATION ------------------------------------------------------
  2388.  
  2389.       This program is SHAREWARE. It represents hundreds of hours of effort.
  2390.       I have been adding features and improving it for over 3 years now.
  2391.       All upgrades have been free. The registration fee is only $30 which
  2392.       I believe to be a fair price for a program of this caliber.
  2393.       Registration is also sort of an investment in the future of EZ-ROM.
  2394.       If people continue to register, I will continue to issue free
  2395.       improvements and upgrades.
  2396.  
  2397.       You may use this program for a free 30 day trial period. After that,
  2398.       you must register it or stop using it. You may give away free copies
  2399.       of this entire unmodified package, but you may not sell it. I retain
  2400.       all rights to this program.
  2401.  
  2402.       As an incentive to encourage registration, the following features
  2403.       are ONLY AVAILABLE IN THE REGISTERED VERSION:
  2404.  
  2405.       ■ The *** UNREGISTERED ***  message on the first screen is replaced
  2406.         by your name and your BBS Name.
  2407.  
  2408.       ■ Requests from offline disks feature is activated.
  2409.  
  2410.       ■ Internal download/request database is activated.
  2411.         Allows EZ-ROM to accurately track and limit downloads on ANY BBS.
  2412.         In the unregistered version, only the caller's daily time limit is
  2413.         enforced. In the unregistered version, downloads are not recorded
  2414.         and file/byte per day limits are not enforced.
  2415.  
  2416.       ■ Batch files are called before and after a download to allow
  2417.         insertion of BBS advertisements into ZIP files or any other
  2418.         function you can execute from a batch file.
  2419.  
  2420.       ■ EZ-ROM will read and write the number of files/bytes downloaded in
  2421.         the BBS specific files for Wildcat 3.x & 4.x, PCBoard,
  2422.         RemoteAccess, ProBoard, Maximus 2.x & 3.x, and TAG. The files are
  2423.         then read back by the BBS so that the caller download statistics
  2424.         are updated in the BBS caller database.
  2425.  
  2426.       ■ EZ-ROM will also write the number of files/bytes downloaded to
  2427.         DOOR.SYS. This file is read back by TriBBS 10 so that the caller
  2428.         download statistics are updated in the TriBBS caller database.
  2429.         This will also work on any other BBS type that can read back
  2430.         DOOR.SYS when the caller exits from the door.
  2431.  
  2432.       ■ External protocols (optional) using DSZ are activated. Only the
  2433.         internal protocols are available in the unregistered version.
  2434.  
  2435.       ■ WELCOME.CLR or WELCOME.BBS file will be displayed (optional).
  2436.  
  2437.       ■ Full logging of all caller activities. You can log activities to
  2438.         your BBS log, or to a separate EZ-ROM log.
  2439.         In the unregistered version, only error conditions are logged.
  2440.         No caller activity log is created in the unregistered version.
  2441.  
  2442.       HOW TO REGISTER:
  2443.  
  2444.       Please fill out and mail the registration form in file REGISTER.DOC.
  2445.       The form is also included below in this file.
  2446.       Or call my BBS for fast online registration using your credit card.
  2447.       I accept Visa, Mastercard, Carte Blanche, Diners' Club.
  2448.       Call The Soft Parade BBS at:  203-922-1794  or  203-924-5603
  2449.  
  2450.       You can also register on CompuServe using GO SWREG and selecting
  2451.       registration of program number 6580. The charge will be added to your
  2452.       CompuServe bill.
  2453.  
  2454.       I fully support both registered and unregistered versions. Node 2
  2455.       (203-922-1794  FidoNet 1:141/486) is dedicated exclusively to
  2456.       handling support for my shareware. Traffic on this node is very
  2457.       light, and it is almost always ready and waiting for callers.
  2458.  
  2459.       You can also reach me on the Internet, CompuServe, or America Online.
  2460.       I do not check these services every day, so it may be several days
  2461.       before you receive a reply.
  2462.  
  2463.       CompuServe ....... 102363.2051
  2464.       America Online ... TheMikeRob
  2465.       Internet ......... TheMikeRob@aol.com
  2466.  
  2467.       Registered Sysops are entitled to free program support, and free
  2468.       access to all files and features on my BBS. Support is available from
  2469.       me on my BBS, in FidoNet (Wildcat, PCBoard, or Spitfire echos), via
  2470.       direct FidoNet crash netmail, Internet, CompuServe, or America
  2471.       Online.
  2472.  
  2473.       When you register, you will receive a customized personal
  2474.       registration key file and instruction file. The key file activates
  2475.       the registered features in the shareware version, so there will be no
  2476.       need to download any specially compiled versions of the executable
  2477.       program itself. All upgrades have been free to all registered users
  2478.       and I intend to continue this policy.
  2479.  
  2480.       Please be sure to specify your name and your BBS name exactly as you
  2481.       would like them to appear on the first door screen.
  2482.  
  2483.       ---------------------------------------------------------
  2484.       ---------------------------------------------------------
  2485.       ---------------------------------------------------------
  2486.  
  2487.       ---------- EZ-ROM 2.20 Door REGISTRATION FORM -----------
  2488.  
  2489.       Your Name: ______________________________________________
  2490.  
  2491.       BBS Name:  ______________________________________________
  2492.  
  2493.       Address:   ______________________________________________
  2494.  
  2495.       Address:   ______________________________________________
  2496.  
  2497.       BBS Phone Number or FidoNet address: ____________________
  2498.  
  2499.       Please answer the following if you want to charge your registration:
  2500.       Credit Card Type: _____________________
  2501.       Name as it appears on the card: _______________________________
  2502.       Credit Card Number: ___________________________________________
  2503.       Expiration Date: _______  Signature: __________________________
  2504.  
  2505.       Please choose ONE of the following registration options:
  2506.  
  2507.       ___ $30 (Thirty Dollars)
  2508.           Call Mike Robinson's BBS and download your registration file.
  2509.           I will establish an account for you in advance if you give the
  2510.           following logon information:
  2511.  
  2512.           Password to use on  Mike Robinson's BBS: _____________________
  2513.  
  2514.           BirthDate to use on Mike Robinson's BBS: _____________________
  2515.  
  2516.       ___ $35 (Thirty Five Dollars) - First Class Mail anywhere in the world.
  2517.           I will mail your registration to you. Specify floppy disk type.
  2518.           3.5 inch HD will be used if not otherwise specified.
  2519.  
  2520.       ___ $35 (Thirty Five Dollars) USA and CANADA ONLY.
  2521.           I will call your BBS and upload your registration to you or
  2522.           I will NetMail your registration to your FidoNet address.
  2523.  
  2524.       ---------------------------------------------------------
  2525.       ---------------------------------------------------------
  2526.       ---------------------------------------------------------
  2527.  
  2528.       Send this form and payment in US DOLLARS to:
  2529.  
  2530.           MICHAEL ROBINSON
  2531.           PO BOX 831
  2532.           SHELTON, CT. 06484-4386
  2533.  
  2534.       Or call either BBS node for fast online registration using
  2535.       your credit card.
  2536.  
  2537.       I accept Visa, Mastercard, Diners' Club, Carte Blanche, personal
  2538.       check, bank check, or money orders. Checks must be from a bank or
  2539.       financial institution with a cashing address within the USA listed on
  2540.       the front of the check. Most major banks in other countries can issue
  2541.       such an international money order or international bank check.
  2542.  
  2543.       Legal Stuff:
  2544.       Use this program at your own risk. No guarantees of any sort.
  2545.       Modification of executable files is prohibited.
  2546.       File sharing and locking implemented via BCSHARE Beta Version 0.7
  2547.       Copyright (C) 1990 - 1994 by Mike Woltz, Buffalo Creek Software.
  2548.       DSZ program Copyright by Omen Technology Inc.
  2549.  
  2550.       Please register your shareware. Authors need your support.
  2551.  
  2552.       EZ-ROM Revision History
  2553.       Version 1.20  -- May 31, 1993 - Initial Public Release.
  2554.       Version 1.30  -- Jan 31, 1994
  2555.       Version 1.30h -- Apr  2, 1994
  2556.       Version 1.30i -- Oct  8, 1994
  2557.       Version 2.00  -- Nov 27, 1994 - Internal protocols, Fossil, DigiBoard.
  2558.       Version 2.10  -- May 31, 1995 - AutoMenu, Disk Detect, List Maker.
  2559.       Version 2.20  -- Jan 14, 1996 - Support RA, ProBoard, Maximus, TAG.
  2560.  
  2561.       Each of these was a FREE upgrade to all registered users.
  2562.  
  2563.       *******************************************************************
  2564.  
  2565.       OTHER PROGRAMS BY MIKE ROBINSON:
  2566.  
  2567.       * Multi-Call Callback Verify Door for any BBS *
  2568.       Multi-CALL is a callback verify door for any DOS BBS that creates
  2569.       DOOR.SYS, DORINFOx.DEF, SFDOORS.DAT. It supports a plain UART, FOSSIL
  2570.       driver, or DigiBoard. It drops carrier and then calls the user back.
  2571.       It can then increase the caller security level and/or increase the
  2572.       time online. DIRECT SUPPORT (read and write) for the following BBS
  2573.       types: Wildcat 3.x & 4.x, PCBoard, Spitfire, RemoteAccess, ProBoard,
  2574.       Maximus 2.x & 3.x, TAG, TriBBS All screens/messages/prompts can be
  2575.       customized for any language. Flexible phone number format for use in
  2576.       any country. Allow or disallow long-distance calls. Limit access by
  2577.       phone number, calls per day, time of day, and security level.
  2578.       Optional hangup after callback. Special support for Wildcat and
  2579.       Maximus word style security level names such as LIMITED, SYSOP, etc.
  2580.       Writes to 4 different log files: BBS log, MultiCall log, log of calls
  2581.       today, and log of all good callbacks. Optional "fake mode" for
  2582.       instant verify without callback. Optional dial number translations
  2583.       for special situations.  Fast online registration is only $25.
  2584.  
  2585.       * Multi-Menu Door for any BBS *
  2586.       MultiMenu is a menu extension door for any BBS that creates a
  2587.       DOOR.SYS, DORINFOx.DEF, or SFDOORS.DAT door drop file. It uses either
  2588.       a plain UART, FOSSIL driver, or DigiBoard Driver. It will work on
  2589.       multi-port IO cards that utilize a shared IRQ. Up to 254 doors,
  2590.       access control by security/age/baud/password, automatic display
  2591.       generation, custom display screens, Ansi/Ascii graphics, optional
  2592.       status line, port speed up to 115,200 bps, DESQview aware,
  2593.       multi-node and network support, file sharing and locking, chat mode,
  2594.       local drop to Dos, carrier detect, inactivity timeout, activity log.
  2595.       Very easy to setup. Can run in local mode in the BBS or from the DOS
  2596.       command line. MultiMenu exits with an ErrorLevel which is then used
  2597.       in a batch file to pass control to the selected external door or
  2598.       other program.  Fast online registration is only $20.00.
  2599.  
  2600.       * SF-ROM CD-ROM Door for Spitfire BBS *
  2601.       SF-ROM is based on the same base source code as EZ-ROM. It is
  2602.       designed specifically for use on Spitfire BBS. The configuration,
  2603.       file format, and appearance is exactly the same as EZ-ROM. Whenever
  2604.       new features are added, they appear simultaneously in new releases of
  2605.       both EZ-ROM and SF-ROM. The revision numbering scheme is the same so,
  2606.       for example, SF-ROM 2.20 is the equivalent of EZ-ROM 2.20. So if you
  2607.       run Spitfire BBS, get SF-ROM. All other BBS types should use EZ-ROM.
  2608.       Fast online registration is only $30.00.
  2609.  
  2610.       *******************************************************************
  2611.  
  2612.       The latest versions of all my programs can be downloaded from either
  2613.       node of my BBS or any of the following locations:
  2614.  
  2615.       America Online .... Computing, TeleCom Forum, BBS Doors library
  2616.       CompuServe ........ GO PCBBS, BBS Doors
  2617.       Internet .......... users.aol.com  ( directory TheMikeRob/pub )
  2618.       Internet .......... ftp.coast.net  ( directory Simtel/msdos/bbsdoor )
  2619.       Both Internet sites allow anonymous ftp file transfer.
  2620.       The Simtel site is "mirrored" at dozens of sites around the world.
  2621.  
  2622.       The file names are ezromxxx.zip, sfromxxx.zip, mcallxxx.zip,
  2623.       mmenuxxx.zip. The "xxx" symbolizes the version number.
  2624.  
  2625.       You can also REGISTER on CompuServe using GO SWREG number 6580.
  2626.  
  2627.       The Soft Parade BBS - Shelton Connecticut USA
  2628.       Home of the EZ-ROM, SF-ROM, Multi-CALL and Multi-MENU Doors.
  2629.       Node 1  203-924-5603  FidoNet 1:141/485  General Public Access
  2630.       Node 2  203-922-1794  FidoNet 1:141/486  Shareware Support Only
  2631.       File Request EZROM, SFROM, MCALL, MMENU for latest versions.
  2632.       File Request EZROM.NEW, SFROM.NEW, MCALL.NEW, MMENU.NEW text file.
  2633.  
  2634.       I can also be reached via EMail at the following locations:
  2635.  
  2636.       Internet ......... TheMikeRob@aol.com
  2637.       America Online ... TheMikeRob
  2638.       CompuServe........ 102363.2051
  2639.  
  2640.       *******************************************************************
  2641.  
  2642.       PKZIP archive security notice for this archive should read:
  2643.       Authentic files Verified!   # FEZ251
  2644.       MICHAEL N. ROBINSON
  2645.  
  2646.